{"id":30009758,"url":"https://github.com/postmanlabs/postman-mcp-server","last_synced_at":"2026-06-08T18:01:02.857Z","repository":{"id":298902223,"uuid":"999484455","full_name":"postmanlabs/postman-mcp-server","owner":"postmanlabs","description":"Connect your AI to your APIs on Postman","archived":false,"fork":false,"pushed_at":"2026-05-19T14:16:48.000Z","size":902,"stargazers_count":252,"open_issues_count":10,"forks_count":75,"subscribers_count":6,"default_branch":"main","last_synced_at":"2026-06-03T03:02:23.554Z","etag":null,"topics":["ai","mcp","mcp-server","postman"],"latest_commit_sha":null,"homepage":"https://www.postman.com/product/mcp-server/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/postmanlabs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-06-10T10:17:39.000Z","updated_at":"2026-06-01T17:48:22.000Z","dependencies_parsed_at":"2025-06-13T14:43:59.516Z","dependency_job_id":"8e20a6d5-36b3-4026-a49e-34d78ce24d57","html_url":"https://github.com/postmanlabs/postman-mcp-server","commit_stats":null,"previous_names":["postmanlabs/postman-api-mcp","postmanlabs/postman-mcp-server"],"tags_count":46,"template":false,"template_full_name":null,"purl":"pkg:github/postmanlabs/postman-mcp-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/postmanlabs%2Fpostman-mcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/postmanlabs%2Fpostman-mcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/postmanlabs%2Fpostman-mcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/postmanlabs%2Fpostman-mcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/postmanlabs","download_url":"https://codeload.github.com/postmanlabs/postman-mcp-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/postmanlabs%2Fpostman-mcp-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34073810,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-08T02:00:07.615Z","response_time":111,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","mcp","mcp-server","postman"],"created_at":"2025-08-05T11:02:36.285Z","updated_at":"2026-06-08T18:01:02.847Z","avatar_url":"https://github.com/postmanlabs.png","language":"TypeScript","funding_links":[],"categories":["Developer Tools","Servers","Official Servers","📦 Other","📚 Projects (2474 total)","MCP Servers \u0026 Protocol","Development Tools Mcp Servers"],"sub_categories":["API Tools","Developer Tools","MCP Servers"],"readme":"# Postman MCP Server\n\nThe Postman MCP Server connects Postman to AI tools, giving AI agents and assistants the ability to access workspaces, manage collections and environments, evaluate APIs, and automate workflows through natural language interactions.\n\nPostman supports the following tool configurations:\n\n* **Minimal** — (Default) Only includes essential tools for basic Postman operations This offers faster performance and simplifies use for those who only need basic Postman operations. Ideal for users who want to modify a single Postman elements, such as collections, workspaces, or environments.\n* **Full** — Includes all available Postman API tools (100+ tools). This configuration is ideal for users who engage in advanced collaboration and Postman's Enterprise features.\n* **Code** — Includes tools to generate high-quality, well-organized client code from public and internal API definitions. This configuration is ideal for users who need to consume APIs or simply get context about APIs to their agents.\n\nFor a complete list of the Postman MCP Server's tools, see the [Postman MCP Server collection](https://www.postman.com/postman/postman-public-workspace/collection/681dc649440b35935978b8b7). This collection offers both the remote [full](https://www.postman.com/postman/postman-public-workspace/mcp-request/6821a76b17ccb90a86df48d3) and [minimal](https://www.postman.com/postman/postman-public-workspace/mcp-request/689e1c635be722a98b723238) servers, and the [local server](https://www.postman.com/postman/postman-public-workspace/mcp-request/6866a655b36c67cc435b5033).\n\nPostman also offers servers as an [npm package](https://www.npmjs.com/package/@postman/postman-mcp-server).\n\n### Authentication\n\nFor the best developer experience and fastest setup, use **OAuth** on the remote server (`https://mcp.postman.com`). OAuth is fully compliant with the [MCP Authorization specification](https://modelcontextprotocol.io/specification/draft/basic/authorization) and requires no manual API key configuration. The EU remote server and the [local server](#local-server) (this repo/npm package) support only [Postman API key](https://postman.postman.co/settings/me/api-keys) authentication.\n\n### Use Cases\n\n* **API Testing** — Continuously test your API using your Postman collection. To be able to test local APIs, use the [local server](#local-server), as the remote server won't have network access to your workstation.\n* **Code synchronization** — Effortlessly keep your code in sync with your [Postman Collections](https://learning.postman.com/docs/design-apis/collections/overview/) and specs.\n* **Collection management** — Create and [tag](https://learning.postman.com/docs/collections/use-collections/collaborate-with-collections/#tag-a-collection) collections, update collection and request [documentation](https://learning.postman.com/docs/publishing-your-api/api-documentation-overview/), add [comments](https://learning.postman.com/docs/collaborating-in-postman/comments/), or perform actions across multiple collections without leaving your editor.\n* **Workspace and environment management** — Create [workspaces](https://learning.postman.com/docs/collaborating-in-postman/using-workspaces/overview/) and [environments](https://learning.postman.com/docs/sending-requests/variables/managing-environments/), plus manage your environment variables.\n* **Automatic spec creation** — Create [specs](https://learning.postman.com/docs/design-apis/specifications/overview/) from your code and use them to generate collections.\n* **Client code generation** — Generate production-ready client code that consumes APIs following best practices and project conventions. The `code` toolset produces code that precisely matches your API definitions, organizes it into an intuitive tree structure mirroring your Postman collections and requests, and leverages example responses to create accurate response types and error handling.\n\nDesigned for developers who want to integrate their AI tools with Postman's context and features. Supports quick natural language queries to advanced agent workflows.\n\n### Support for EU\n\nThe Postman MCP Server supports the EU region for remote and local servers:\n\n* For streamable HTTP, the remote server is available at `https://mcp.eu.postman.com/mcp` (Full), `https://mcp.eu.postman.com/code`, and `https://mcp.eu.postman.com/minimal`.\n* For the STDIO public package, use the `--region eu` flag to specify the Postman API EU region, or set the `POSTMAN_API_BASE_URL` environment variable directly.\n* OAuth isn't supported for the EU Postman MCP Server. The EU remote server only supports API key authentication.\n\n---\n\n## Contents\n\n* [**Remote server**](#remote-server)\n  * [**Claude Code**](#install-in-claude-code)\n  * [**Cursor**](#install-in-cursor)\n  * [**VS Code**](#install-in-visual-studio-code)\n  * [**Codex**](#install-in-codex)\n  * [**Windsurf**](#install-in-windsurf)\n  * [**Antigravity**](#install-in-antigravity)\n  * [**GitHub Copilot CLI**](#install-in-github-copilot-cli)\n  * [**Gemini CLI**](#install-in-gemini-cli)\n  * [**Kiro**](#install-in-kiro)\n* [**Local server**](#local-server)\n  * [**Claude Code**](#install-in-claude-code-1)\n  * [**Cursor**](#install-in-cursor-1)\n  * [**VS Code**](#install-in-visual-studio-code-1)\n  * [**Claude**](#claude-integration)\n  * [**Codex**](#install-in-codex-1)\n  * [**Windsurf**](#install-in-windsurf-1)\n  * [**Antigravity**](#install-in-antigravity-1)\n  * [**GitHub Copilot CLI**](#install-in-github-copilot-cli-1)\n  * [**Gemini CLI**](#install-in-gemini-cli-1)\n  * [**Gemini CLI extension**](#use-as-a-gemini-cli-extension)\n  * [**Kiro**](#install-in-kiro)\n  * [**Docker**](#install-in-docker)\n* [**Questions and support**](#questions-and-support)\n* [**Migration from Postman MCP Server v1 to v2**](#migration-from-v1x-to-v2x)\n\n---\n\n## Remote server\n\nThe remote Postman MCP Server is hosted by Postman over streamable HTTP and provides the easiest method for getting started.\n\nThe remote server (`https://mcp.postman.com`) supports OAuth for the best developer experience and fastest setup, and no API key needed. OAuth also provides stronger security and fine-grained access control compared to a static API key. OAuth is MCP specification–compliant, including Dynamic Client Registration (DCR), OAuth metadata, and PKCE.\n\n**Note:** The EU remote server (`https://mcp.eu.postman.com`) only supports API key authentication.\n\nMCP hosts that support OAuth can discover and use it automatically for all tools. The remote server also accepts a [Postman API key](https://postman.postman.co/settings/me/api-keys) (Bearer token in the Authorization header).\n\n**Why use the remote server?**\n\nConsider using the remote Postman MCP server if:\n\n* Your MCP host doesn't support local MCP servers.\n* You want a quick way to get started with the Postman MCP server.\n* You are working with public APIs.\n\n**Supported configurations**\n\nThe remote server supports the following tool configurations:\n\n* **Minimal** — (Default) Only includes essential tools for basic Postman operations, available at `https://mcp.postman.com/minimal` and `https://mcp.eu.postman.com/minimal` for EU users. This offers faster performance and simplifies use for those who only need basic Postman operations.\n* **Code** — Includes tools for searching public and internal API definitions and generating client code, available at `https://mcp.postman.com/code` and `https://mcp.eu.postman.com/code` for EU users. This configuration is ideal for users who need to consume APIs or get context about APIs to their agents.\n* **Full** — Includes all available Postman API tools (100+ tools), available at `https://mcp.postman.com/mcp` and `https://mcp.eu.postman.com/mcp` for EU users.\n\n### Install in Cursor\n\n[![Install in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=postman_mcp_server\u0026config=eyJ1cmwiOiJodHRwczovL21jcC5wb3N0bWFuLmNvbS9taW5pbWFsIiwiaGVhZGVycyI6eyJBdXRob3JpemF0aW9uIjoiQmVhcmVyIFlPVVJfQVBJX0tFWSJ9fQ%3D%3D)\n\nTo install the remote Postman MCP Server in Cursor, click the install button.\n\nIf your MCP host supports OAuth, use the `https://mcp.postman.com/mcp`, `https://mcp.postman.com/minimal`, or `https://mcp.postman.com/code` server URL without headers for the fastest setup. Otherwise, ensure the Authorization header uses the `Bearer \u003cYOUR_API_KEY\u003e` format. Note that OAuth isn’t supported for EU servers.\n\nAfter installing, ensure that the Authorization header uses the `Bearer $POSTMAN-API-KEY` format.\n\nTo access **Full** mode, change the `url` value to `https://mcp.postman.com/mcp` in the `mcp.json` file. To access **Code** mode, change the value to `https://mcp.postman.com/code` in this file.\n\n### Install in Visual Studio Code\n\nTo install the remote Postman MCP Server in VS Code, click the install button or use the [Postman VS Code Extension](https://marketplace.visualstudio.com/items?itemName=Postman.postman-for-vscode).\n\n[![Install in VS Code](https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=flat-square\u0026logo=visualstudiocode\u0026logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=postman_mcp_server\u0026config=%7B%22type%22%3A%20%22http%22%2C%22url%22%3A%20%22https%3A%2F%2Fmcp.postman.com%2Fminimal%22%2C%22headers%22%3A%7B%22Authorization%22%3A%22Bearer%20YOUR_API_KEY%22%7D%7D)\n\nTo access **Full** mode, change the `url` value to `https://mcp.postman.com/mcp` in the `mcp.json` file. To access **Code** mode, change the value to `https://mcp.postman.com/code` in this file.\n\n#### Manual configuration\n\nYou can use the Postman MCP Server with MCP-compatible extensions in VS Code, such as GitHub Copilot, Claude for VS Code, or other AI assistants that support MCP. To do so, add the following JSON block to the `.vscode/mcp.json` configuration file:\n\n##### OAuth\n\nAdd the following JSON block to use the recommended OAuth installation method:\n\n```json\n{\n    \"servers\": {\n        \"postman\": {\n            \"type\": \"http\",\n            \"url\": \"https://mcp.postman.com/minimal\"\n                // \"https://mcp.postman.com/code\" for Code mode\n                // \"https://mcp.postman.com/mcp\" for Full mode\n        }\n    }\n}\n```\n\nStart the server. When prompted, enter your Postman API key.\n\n##### API key\n\nUse the following JSON block to use the API key installation method:\n\n```json\n{\n    \"servers\": {\n        \"postman\": {\n            \"type\": \"http\",\n            \"url\": \"https://mcp.postman.com/minimal\",\n                // \"https://mcp.postman.com/code\" for Code mode\n                // \"https://mcp.postman.com/mcp\" for Full mode\n            \"headers\": {\n                \"Authorization\": \"Bearer ${input:postman-api-key}\"\n            }\n        }\n    },\n    \"inputs\": [\n        {\n            \"id\": \"postman-api-key\",\n            \"type\": \"promptString\",\n            \"description\": \"Enter your Postman API key\"\n        }\n    ]\n}\n```\n\nStart the server. When prompted, enter your Postman API key.\n\n### Install in Claude Code\n\nOn the US server, Claude Code automatically uses OAuth for the best installation experience. To use an API key (required for the EU server), add the `--header` flag.\n\n#### OAuth\n\nTo use the OAuth installation method for US servers, run the following command in your terminal:\n\n##### Minimal\n\n```bash\nclaude mcp add --transport http postman https://mcp.postman.com/minimal\n```\n\n##### Code\n\n```bash\nclaude mcp add --transport http postman https://mcp.postman.com/code\n```\n\n##### Full\n\n```bash\nclaude mcp add --transport http postman https://mcp.postman.com/mcp\n```\n\n#### API key\n\nTo use the API key installation method if required and for EU servers (`mcp.eu.postman`), run the following command in your terminal:\n\n##### Minimal\n\n```bash\nclaude mcp add --transport http postman https://mcp.postman.com/minimal --header \"Authorization: Bearer \u003cPOSTMAN_API_KEY\u003e\"\n```\n\n##### Code\n\n```bash\nclaude mcp add --transport http postman https://mcp.postman.com/code --header \"Authorization: Bearer \u003cPOSTMAN_API_KEY\u003e\"\n```\n\n##### Full\n\n```bash\nclaude mcp add --transport http postman https://mcp.postman.com/mcp --header \"Authorization: Bearer \u003cPOSTMAN_API_KEY\u003e\"\n```\n\n### Codex\n\nTo install the remote server in Codex, use one of the following methods, depending on your authentication and region.\n\n#### OAuth\n\nUse this method with the US server for the best installation experience. OAuth requires no manual API key setup.\n\n##### Minimal\n\n```bash\ncodex mcp add postman --remote-url https://mcp.postman.com/minimal\n```\n\n##### Code\n\n```bash\ncodex mcp add postman --remote-url https://mcp.postman.com/code\n```\n\n##### Full\n\n```bash\ncodex mcp add postman --remote-url https://mcp.postman.com/mcp\n```\n\n#### API key\n\nIf you're using the EU server (`mcp.eu.postman`), a [local server](/docs/developer/postman-api/postman-mcp-server/postman-mcp-local-server#codex), or prefer API key authentication, use the API key method. Set the `POSTMAN_API_KEY` environment variable and invoke the MCP server using `npx`.\n\n##### Minimal\n\n```bash\ncodex mcp add postman --env POSTMAN_API_KEY=\u003cPOSTMAN_API_KEY\u003e -- npx @postman/postman-mcp-server --minimal\n```\n\n##### Code\n\n```bash\ncodex mcp add postman --env POSTMAN_API_KEY=\u003cPOSTMAN_API_KEY\u003e -- npx @postman/postman-mcp-server --code\n```\n\n##### Full\n\n```bash\ncodex mcp add postman --env POSTMAN_API_KEY=\u003cPOSTMAN_API_KEY\u003e -- npx @postman/postman-mcp-server --full\n```\n\n#### Manual installation\n\nTo manually install the MCP server in Codex, create a `~/.codex/config.toml` config file, then copy the following config into the file:\n\n```plaintext\n[mcp_servers.postman-mcp-server]\ncommand = \"npx\"\nargs = [\"-y\", \"@postman/postman-mcp-server\"]\n\n[mcp_servers.postman-mcp-server.env]\nPOSTMAN_API_KEY=\"XXX\"\n```\n\n### Install in Windsurf\n\nTo install the MCP server in Windsurf, copy the following JSON config into the `.codeium/windsurf/mcp_config.json` file. This configuration uses the remote server, which automatically authenticates with OAuth.\n\n```json\n{\n    \"mcpServers\": {\n        \"postman-full\": {\n            \"args\": [\n                \"mcp-remote\",\n                \"https://mcp.postman.com/mcp\"\n            ],\n            \"disabled\": false,\n            \"disabledTools\": [],\n            \"env\": {}\n        },\n        \"postman-code\": {\n            \"args\": [\n                \"mcp-remote\",\n                \"https://mcp.postman.com/code\"\n            ],\n            \"disabled\": false,\n            \"disabledTools\": [],\n            \"env\": {}\n        },\n        \"postman-minimal\": {\n            \"args\": [\n                \"mcp-remote\",\n                \"https://mcp.postman.com/minimal\"\n            ],\n            \"disabled\": false,\n            \"disabledTools\": [],\n            \"env\": {}\n        }\n    }\n}\n```\n\n### Install in Antigravity\n\nTo install the MCP server in Antigravity, click **Manage MCP servers \u003e View raw config**. Then, copy the following JSON config into the `.mcp_config.json` file. This configuration uses the remote server, which automatically authenticates with OAuth.\n\n```json\n{\n    \"mcpServers\": {\n        \"postman-full\": {\n            \"args\": [\n                \"mcp-remote\",\n                \"https://mcp.postman.com/mcp\"\n            ],\n            \"disabled\": false,\n            \"disabledTools\": [],\n            \"env\": {}\n        },\n        \"postman-code\": {\n            \"args\": [\n                \"mcp-remote\",\n                \"https://mcp.postman.com/code\"\n            ],\n            \"disabled\": false,\n            \"disabledTools\": [],\n            \"env\": {}\n        },\n        \"postman-minimal\": {\n            \"args\": [\n                \"mcp-remote\",\n                \"https://mcp.postman.com/minimal\"\n            ],\n            \"disabled\": false,\n            \"disabledTools\": [],\n            \"env\": {}\n        }\n    }\n}\n```\n\n### Install in GitHub Copilot CLI\n\nYou can add the MCP server to your Copilot CLI either with OAuth (recommended) or an API key.\n\nUse the Copilot CLI to interactively add the MCP server:\n\n```bash\n/mcp add\n```\n\n#### Manual installation\n\nOr, add the following to your `~/.copilot/mcp-config.json` config file:\n\n```json\n{\n    \"mcpServers\": {\n        \"postman\": {\n            \"type\": \"http\",\n            \"url\": \"https://mcp.postman.com/minimal\"\n                // \"https://mcp.postman.com/mcp\" for Full mode\n                // \"https://mcp.postman.com/code\" for Code mode\n        }\n    }\n}\n```\n\n##### API key\n\nUse the following method to install if API key authentication is required for EU servers:\n\n```json\n{\n    \"mcpServers\": {\n        \"postman\": {\n            \"type\": \"http\",\n            \"url\": \"https://mcp.eu.postman.com/minimal\",\n                // \"https://mcp.eu.postman.com/mcp\" for Full mode\n                // \"https://mcp.eu.postman.com/code\" for Code mode\n            \"headers\": {\n                \"Authorization\": \"Bearer ${input:postman-api-key}\"\n            }\n        }\n    },\n    \"inputs\": [\n        {\n            \"id\": \"postman-api-key\",\n            \"type\": \"promptString\",\n            \"description\": \"Enter your Postman API key\"\n        }\n    ]\n}\n```\n\nBy default, this uses **Minimal** mode. To access **Full** mode, change the `url` value to `https://mcp.postman.com/mcp`. To access **Code** mode, change the value to `https://mcp.postman.com/code`.\n\nFor more information, see the [Copilot CLI documentation](https://docs.github.com/en/copilot/concepts/agents/about-copilot-cli).\n\n### Install in Gemini CLI\n\nTo add the MCP server to your Gemini CLI run the following command in your terminal\n\n```bash\ngemini mcp add postman https://mcp.postman.com/mcp --transport http\n```\n\n### Install in Kiro\n\nTo install the remote Postman MCP Server in Kiro, click the install button for the version that you want to use:\n\n| **Minimal** | **Code** | **Full**\n| --- | -- | -- |\n| [![Add Postman MCP Minimal server to Kiro](https://kiro.dev/images/add-to-kiro.svg)](https://kiro.dev/launch/mcp/add?name=postman-mcp-server\u0026config=%7B%22url%22%3A%22https%3A%2F%2Fmcp.postman.com%2Fminimal%22%2C%22disabled%22%3Afalse%2C%22autoApprove%22%3A%5B%5D%7D) | [![Add Postman MCP Code server to Kiro](https://kiro.dev/images/add-to-kiro.svg)](https://kiro.dev/launch/mcp/add?name=postman-mcp-server\u0026config=%7B%22url%22%3A%22https%3A%2F%2Fmcp.postman.com%2Fcode%22%2C%22disabled%22%3Afalse%2C%22autoApprove%22%3A%5B%5D%7D) | [![Add Postman MCP Full server to Kiro](https://kiro.dev/images/add-to-kiro.svg)](https://kiro.dev/launch/mcp/add?name=postman-mcp-server\u0026config=%7B%22url%22%3A%22https%3A%2F%2Fmcp.postman.com%2Fmcp%22%2C%22disabled%22%3Afalse%2C%22autoApprove%22%3A%5B%5D%7D) |\n\n---\n\n## Local server\n\nThe local server uses STDIO transport and is hosted locally on an environment of your choice.\n\n**Why use the local server?**\n\nConsider using the local Postman MCP server if:\n\n* You are working with internal APIs.\n* You want to power local use cases, such as local API testing.\n* You have specific security and network requirements.\n* You prefer to build the MCP server from the source code in this repo.\n\n**Supported configurations**\n\nThe local server supports the following tool configurations:\n\n* **Minimal** — (Default) Only includes essential tools for basic Postman operations.\n* **Code** — Includes tools for searching public and internal API definitions and generating client code.\n* **Full** — Includes all available Postman API tools (100+ tools).\n* **Quiet** — This option suppresses `debug` and `info` logs in stderr, and returns only `warn` and `error`. This mode is required for **Windsurf** users on Windows, as it avoids a stderr pipe buffer deadlock that results in MCP initializing a request to timeout. You can enable this mode along with the **Minimal**, **Code**, or **Full** configuration.\n\n**Note:**\n* Use the `--region` flag to specify the Postman API region (`us` or `eu`), or set the `POSTMAN_API_BASE_URL` environment variable directly. By default, the server uses the `us` option.\n* The local server only supports API key authentication (with a Postman API key or Bearer token). To run the server as a Node application, install [Node.js](https://nodejs.org/en).\n\n### Install in Visual Studio Code\n\n[![Install with Node in VS Code](https://img.shields.io/badge/VS_Code-Install_Server-0098FF?style=flat-square\u0026logo=visualstudiocode\u0026logoColor=white)](https://insiders.vscode.dev/redirect/mcp/install?name=postman-api-mcp\u0026inputs=%5B%7B%22id%22%3A%22postman-api-key%22%2C%22type%22%3A%22promptString%22%2C%22description%22%3A%22Enter%20your%20Postman%20API%20key%22%7D%5D\u0026config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22%40postman%2Fpostman-mcp-server%22%2C%22--full%22%5D%2C%22env%22%3A%7B%22POSTMAN_API_KEY%22%3A%22%24%7Binput%3Apostman-api-key%7D%22%7D%7D)\n\nTo install the local Postman MCP Server in VS Code, click the install button.\n\nBy default, the server uses **Full** mode. To access **Minimal** mode, remove the `--full` flag from the `mcp.json` configuration file. To access **Code** mode, replace the `--full` flag with `--code`.\n\n#### Manual configuration\n\nYou can manually integrate your MCP server with VS Code to use it with extensions that support MCP. To do this, create a `mcp.json` file in your project and add the following JSON block to it:\n\n```json\n{\n    \"servers\": {\n        \"postman\": {\n            \"type\": \"stdio\",\n            \"command\": \"npx\",\n            \"args\": [\n                \"@postman/postman-mcp-server\",\n                \"--full\", // (optional) Use this flag to enable full mode...\n                \"--code\", // (optional) ...or this flag to enable code mode.\n                \"--region us\" // (optional) Use this flag to specify the Postman API region (us or eu). Defaults to us.\n            ],\n            \"env\": {\n                \"POSTMAN_API_KEY\": \"${input:postman-api-key}\"\n            }\n        }\n    },\n    \"inputs\": [\n        {\n            \"id\": \"postman-api-key\",\n            \"type\": \"promptString\",\n            \"description\": \"Enter your Postman API key\"\n        }\n    ]\n}\n```\n\n### Install in Cursor\n\n[![Install with Node in Cursor](https://cursor.com/deeplink/mcp-install-dark.svg)](https://cursor.com/en/install-mcp?name=postman-api-mcp\u0026config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyJAcG9zdG1hbi9wb3N0bWFuLW1jcC1zZXJ2ZXIiLCItLWZ1bGwiXSwiZW52Ijp7IlBPU1RNQU5fQVBJX0tFWSI6IllPVVJfQVBJX0tFWSJ9fQ%3D%3D)\n\nTo install the local Postman MCP Server in Cursor, click the install button.\n\nBy default, the server uses **Full** mode. To access **Minimal** mode, remove the `--full` flag from the `mcp.json` configuration file. To access **Code** mode, replace the `--full` flag with `--code`.\n\n#### Manual installation\n\nTo manually integrate your MCP server with Cursor and VS Code, create a `.vscode/mcp.json` file in your project and add the following JSON block to it:\n\n```json\n{\n    \"servers\": {\n        \"postman\": {\n            \"type\": \"stdio\",\n            \"command\": \"npx\",\n            \"args\": [\n                \"@postman/postman-mcp-server\",\n                \"--full\", // (optional) Use this flag to enable full mode...\n                \"--code\", // (optional) ...or this flag to enable code mode.\n                \"--region us\" // (optional) Use this flag to specify the Postman API region (us or eu). Defaults to us.\n            ],\n            \"env\": {\n                \"POSTMAN_API_KEY\": \"${input:postman-api-key}\"\n            }\n        }\n    },\n    \"inputs\": [\n        {\n            \"id\": \"postman-api-key\",\n            \"type\": \"promptString\",\n            \"description\": \"Enter your Postman API key\"\n        }\n    ]\n}\n```\n\n### Claude integration\n\nTo integrate the MCP server with Claude, check the latest [Postman MCP Server release](https://github.com/postmanlabs/postman-mcp-server/releases) and get the `.mcpb` file.\n\n* **Minimal** — `postman-mcp-server-minimal.mcpb`\n* **Full** — `postman-mcp-server-full.mcpb`\n* **Code** — `postman-mcp-server-code.mcpb`\n\nFor more information, see the [Claude Desktop Extensions](https://www.anthropic.com/engineering/desktop-extensions) documentation.\n\n### Install in Claude Code\n\nTo install the MCP server in Claude Code, run the following command in your terminal:\n\n##### Minimal\n\n```bash\nclaude mcp add postman --env POSTMAN_API_KEY=YOUR_KEY -- npx @postman/postman-mcp-server@latest\n```\n\n##### Code\n\n```bash\nclaude mcp add postman --env POSTMAN_API_KEY=YOUR_KEY -- npx @postman/postman-mcp-server@latest  --code\n```\n\n##### Full\n\n```bash\nclaude mcp add postman --env POSTMAN_API_KEY=YOUR_KEY -- npx @postman/postman-mcp-server@latest --full\n```\n\n### Install in Codex\n\nTo install the local server, use the API key installation method. Set the `POSTMAN_API_KEY` environment variable and invoke the MCP server using `npx`.\n\n##### Minimal\n\n```bash\ncodex mcp add postman --env POSTMAN_API_KEY=\u003cPOSTMAN_API_KEY\u003e -- npx @postman/postman-mcp-server --minimal\n```\n\n##### Code\n\n```bash\ncodex mcp add postman --env POSTMAN_API_KEY=\u003cPOSTMAN_API_KEY\u003e -- npx @postman/postman-mcp-server --code\n```\n\n##### Full\n\n```bash\ncodex mcp add postman --env POSTMAN_API_KEY=\u003cPOSTMAN_API_KEY\u003e -- npx @postman/postman-mcp-server --full\n```\n\n### Install in Windsurf\n\nTo install the MCP server in Windsurf, do the following:\n\n1. Click **Open MCP Marketplace** in Windsurf.\n1. Type \"Postman\" in the search text box to filter the marketplace results.\n1. Click **Install**.\n1. When prompted, enter a valid Postman API key.\n1. Select the tools that you want to enable, or click **All Tools** to select all available tools.\n1. Turn on **Enabled** to enable the Postman MCP server.\n\n\u003e Windows users on Windsurf can hit a startup timeout because too many startup logs fill the stderr buffer, which blocks the server before MCP initialization completes. Using the `--quiet` configuration suppresses those logs and avoids the issue.\n\n#### Manual installation\n\nCopy the following JSON config into the `.codeium/windsurf/mcp_config.json` file:\n\n```json\n{\n    \"mcpServers\": {\n        \"postman\": {\n            \"args\": [\n                \"@postman/postman-mcp-server\",\n                \"--minimal\" // (Default) Use this flag to enable minimal mode.\n                // \"--full\" — Use this flag to enable full mode.\n                // \"--code\" — Use this flag to enable code mode.\n                // \"--quiet\" — Use this flag to enable quiet mode alongside your mode of choice.\n            ],\n            \"command\": \"npx\",\n            \"disabled\": false,\n            \"disabledTools\": [],\n            \"env\": {\n                \"POSTMAN_API_KEY\": \"\u003cPOSTMAN_API_KEY\u003e\"\n            }\n        }\n    }\n}\n```\n\n### Install in Antigravity\n\nTo install the MCP server in Antigravity, click **Manage MCP servers \u003e View raw config**. Then, copy the following JSON config into the `mcp_config.json` file:\n\n```json\n{\n    \"mcpServers\": {\n        \"postman\": {\n            \"args\": [\n                \"@postman/postman-mcp-server\"\n            ],\n            \"command\": \"npx\",\n            \"disabled\": false,\n            \"disabledTools\": [],\n            \"env\": {\n                \"POSTMAN_API_KEY\": \"\u003cPOSTMAN_API_KEY\u003e\"\n            }\n        }\n    }\n}\n\n```\n\n### Install in GitHub Copilot CLI\n\nUse the Copilot CLI to interactively add the MCP server:\n\n```bash\n/mcp add\n```\n\n#### Manual configuration\n\nCopy the following JSON config into the `~/.copilot/mcp-config.json` file:\n\n```json\n{\n    \"mcpServers\": {\n        \"postman\": {\n            \"command\": \"npx\",\n            \"args\": [\n                \"@postman/postman-mcp-server\"\n            ],\n            \"env\": {\n                \"POSTMAN_API_KEY\": \"\u003cPOSTMAN_API_KEY\u003e\"\n            }\n        }\n    }\n}\n```\n\nFor more information, see the [Copilot CLI documentation](https://docs.github.com/en/copilot/concepts/agents/about-copilot-cli).\n\n### Install in Gemini CLI\n\nTo install the MCP server directly in the Gemini CLI, run the following command in your terminal.\n\n```bash\ngemini mcp add postman npx -- -y @postman/postman-mcp-server --env POSTMAN_API_KEY=\u003cYOUR_POSTMAN_API_KEY\u003e\n```\n\n### Use as a Gemini CLI extension\n\nTo install the MCP server as a Gemini CLI extension, run the following command in your terminal:\n\n```bash\ngemini extensions install https://github.com/postmanlabs/postman-mcp-server\n```\n\n### Install in Kiro\n\nTo install the local Postman MCP Server in Kiro, click the install button for the version that you want to use:\n\n| **Minimal** | **Code** | **Full**\n| --- | -- | -- |\n| [![Add Postman MCP Minimal server to Kiro](https://kiro.dev/images/add-to-kiro.svg)](https://kiro.dev/launch/mcp/add?name=postman-mcp-server\u0026config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40postman%2Fpostman-mcp-server%40latest%22%5D%2C%22env%22%3A%7B%22POSTMAN_API_KEY%22%3A%22%24%7BPOSTMAN_API_KEY%7D%22%7D%2C%22disabled%22%3Afalse%2C%22autoApprove%22%3A%5B%5D%7D) | [![Add Postman MCP Code server to Kiro](https://kiro.dev/images/add-to-kiro.svg)](https://kiro.dev/launch/mcp/add?name=postman-mcp-server\u0026config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40postman%2Fpostman-mcp-server%40latest%22%2C%22--code%22%5D%2C%22env%22%3A%7B%22POSTMAN_API_KEY%22%3A%22%24%7BPOSTMAN_API_KEY%7D%22%7D%2C%22disabled%22%3Afalse%2C%22autoApprove%22%3A%5B%5D%7D) | [![Add Postman MCP Full server to Kiro](https://kiro.dev/images/add-to-kiro.svg)](https://kiro.dev/launch/mcp/add?name=postman-mcp-server\u0026config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22%40postman%2Fpostman-mcp-server%40latest%22%2C%22--full%22%5D%2C%22env%22%3A%7B%22POSTMAN_API_KEY%22%3A%22%24%7BPOSTMAN_API_KEY%7D%22%7D%2C%22disabled%22%3Afalse%2C%22autoApprove%22%3A%5B%5D%7D) |\n\nTo install the Postman MCP server with Kiro powers, go to [Kiro Powers](https://kiro.dev/powers/) and navigate to **API Testing with Postman** in the **Browse powers** section. Then, click **Add to Kiro**.\n\n#### Manual configuration\n\nTo install the Postman MCP Server manually, do the following:\n\n1. Launch Kiro and click the Kiro ghost icon in the left sidebar.\n1. Add an MCP Server and select either **User Config** or **Workspace Config** to install the Postman MCP server.\n1. Add the following JSON block to the `mcp.json` configuration file:\n\n    ```json wordWrap\n    {\n        \"mcpServers\": {\n            \"postman\": {\n            \"command\": \"npx\",\n                \"args\": [\n                    \"@postman/postman-mcp-server\"\n                ],\n                \"env\": {\n                    \"POSTMAN_API_KEY\": \"\u003cPOSTMAN_API_KEY\u003e\"\n                },\n                \"disabled\": false,\n                \"autoApprove\": []\n            }\n        }\n    }\n    ```\n\n### Install in Docker\n\nFor Docker set up and installation, see [DOCKER.md](./DOCKER.md).\n\n---\n\n## Migration from v1.x to v2.x\n\nIf you're migrating from Postman MCP Server version 1.x to 2.x, be aware of the following:\n\n* **Tool naming changes** — All tool names changed from kebab-case to camelCase. For example:\n  * `create-collection` → `createCollection`\n  * `get-workspaces` → `getWorkspaces`\n  * `delete-environment` → `deleteEnvironment`\n* **Tool availability changes**\n  * The default (minimal) behavior provides only 37 essential tools.\n  * The `--full` flag provides access to all tools.\n\n---\n\n## Questions and support\n\n* See [Add your MCP requests to your collections](https://learning.postman.com/docs/postman-ai-agent-builder/mcp-requests/overview/) to learn how to use Postman to perform MCP requests.\n* Visit the [Postman Community](https://community.postman.com/) to share what you've built, ask questions, and get help.\n* You can connect to both the remote and local servers and test them using the [Postman MCP Server collection](https://www.postman.com/postman/postman-public-workspace/collection/681dc649440b35935978b8b7).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpostmanlabs%2Fpostman-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpostmanlabs%2Fpostman-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpostmanlabs%2Fpostman-mcp-server/lists"}