postmanlabs/postman-mcp-server

The **Postman MCP Server** implements the Model Context Protocol (MCP) to connect AI agents and coding assistants — including Claude Code, Cursor, VS Code Copilot, GitHub Copilot CLI, and Gemini CLI — directly to your Postman workspaces, collections, specifications, and environments.
Postman also offers the server as an npm package.
For the full installation guide with agent-specific setup, see Postman's MCP Server product page.
---
Postman MCP Server collection
The Postman MCP Server collection is the quickest way to explore, test, and connect to the Postman MCP Server. Use it to:
- Browse the complete list of available tools across all configurations.
- Connect to and test the remote server — Full and Minimal.
- Connect to and test the local server.
---
Tool configurations
- **Minimal** — (Default) Only includes essential tools for basic Postman operations. Ideal for users who want to modify a single Postman element, such as collections, workspaces, or environments.
- **Code** — Includes tools to generate high-quality, well-organized client code from public and internal API definitions. Ideal for users who need to consume APIs or get API context to their agents.
- **Full** — Includes all available Postman API tools (100+ tools). Ideal for users who engage in advanced collaboration and Postman's Enterprise features.
- **Learn** — Searches Postman Docs for guides, tutorials, and reference content. Ideal for agents who need to discover Postman features, look up API concepts, or find learning resources.
---
Authentication
For 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 and requires no manual API key configuration.
The EU remote server and the local server support only Postman API key authentication.
---
Quick start
**Remote** (any OAuth-compatible MCP host):
Add this URL to your MCP host's configuration:
Change /minimal to /code or /mcp for Code or Full mode. For EU or API key auth, pass Authorization: Bearer as a header.
**Local:**
Add --code or --full for Code or Full mode. Set POSTMAN_API_KEY as an environment variable.
For IDE-specific setup instructions, see the following table. For more information, see the Postman MCP Server docs.
---
Supported agents and IDEs
| Agent / IDE | Remote | Local |
| --- | --- | --- |
| Claude Code | Docs | Docs |
| Claude Desktop | Docs | Docs |
| Cursor | Docs | Docs |
| VS Code | Docs | Docs |
| Codex | Docs | Docs |
| Antigravity CLI | Docs | Docs |
| GitHub Copilot CLI | Docs | Docs |
| Kiro | Docs | Docs |
| Docker | — | Docs |
---
EU support
The Postman MCP Server supports the EU region for remote and local servers:
- 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.
- For the STDIO public package, use the --region eu flag, or set the POSTMAN_API_BASE_URL environment variable directly.
- OAuth isn't supported for the EU server. The EU remote server only supports API key authentication.