---
title: filter_project_envs
product: vercel
url: /docs/agent-resources/vercel-mcp/tools/environment-variables/filter_project_envs
canonical_url: "https://vercel.com/docs/agent-resources/vercel-mcp/tools/environment-variables/filter_project_envs"
last_updated: 2018-10-20
type: reference
prerequisites:
  - /docs/agent-resources/vercel-mcp/tools/environment-variables
  - /docs/agent-resources/vercel-mcp/tools
related:
  []
summary: Use filter_project_envs with Vercel MCP.
install_vercel_plugin: npx plugins add vercel/vercel-plugin
---

# filter_project_envs

Retrieve the environment variables of a project by id or name.

## Parameters

| Parameter               | Type   | Required | Description                                                                                             |
| ----------------------- | ------ | -------- | ------------------------------------------------------------------------------------------------------- |
| `idOrName`              | string | Yes      | The unique project identifier or the project name                                                       |
| `gitBranch`             | string | No       | If defined, the git branch of the environment variable to filter the results (must have target=preview) |
| `decrypt`               | string | No       | If true, the environment variable value will be decrypted Allowed values: `"true"`, `"false"`.          |
| `source`                | string | No       | The source that is calling the endpoint.                                                                |
| `customEnvironmentId`   | string | No       | The unique custom environment identifier within the project                                             |
| `customEnvironmentSlug` | string | No       | The custom environment slug (name) within the project                                                   |
| `teamId`                | string | No       | Team ID.                                                                                                |
| `slug`                  | string | No       | Team slug.                                                                                              |


---

[View full sitemap](/docs/sitemap)