postman-mcp-server
Postman MCP Server — connect AI agents (Claude Code, Cursor, VS Code Copilot, Gemini CLI) to your Postman collections, OpenAPI specs, and environments via Model
What is postman-mcp-server?
Postman MCP Server — connect AI agents (Claude Code, Cursor, VS Code Copilot, Gemini CLI) to your Postman collections, OpenAPI specs, and environments via Model Context Protocol (MCP)
Overview of postman-mcp-server
What it is
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 Postman workspaces, collections, specifications, and environments. It is available as an npm package and is licensed under Apache-2.0.
Key features
- Supports four tool configurations: Minimal (default), Code, Full (100+ tools), and Learn (searches Postman Docs).
- Remote server at
https://mcp.postman.comwith OAuth authentication; EU remote server and local server support API key authentication. - Local server can be run via
npx @postman/postman-mcp-serverwith optional--code,--full, or--region euflags. - EU region support: remote server available at
https://mcp.eu.postman.com/mcp(Full),/code, and/minimal; STDIO package uses--region euflag orPOSTMAN_API_BASE_URLenvironment variable. - Docker setup available (see DOCKER.md).
- Bug reports, tool requests, and documentation fixes are welcome via GitHub Issues; changes to
src/are synced from Postman's internal source of truth and cannot be merged directly.
Use cases
- API Testing — Continuously test your API using your Postman collection; use the local server to test local APIs.
- Code synchronization — Keep your code in sync with Postman Collections and specs.
- Collection management — Create and tag collections, update documentation, add comments, or perform actions across multiple collections without leaving your editor.
- Workspace and environment management — Create workspaces and environments, plus manage environment variables.
- Automatic spec creation — Create specs from your code and use them to generate collections.
- Client code generation — Generate production-ready client code that consumes APIs following best practices and project conventions.
Getting started
Remote (any OAuth-compatible MCP host):Add this URL to your MCP host's configuration:bashhttps://mcp.postman.com/minimalChange /minimal to /code or /mcp for Code or Full mode. For EU or API key auth, pass Authorization: Bearer as a header.Local:bashnpx @postman/postman-mcp-serverAdd --code or --full for Code or Full mode. Set POSTMAN_API_KEY as an environment variable.For IDE-specific setup instructions, see the Postman MCP Server docs.
License and pricing
License: Apache-2.0. Pricing: open source (not stated as paid).
Based on the project's public README and repository metadata.