Postman MCP Server
Let AI agents manage your Postman collections, workspaces, and environments over MCP.
Updated
What is Postman MCP?
The Postman MCP server is a Model Context Protocol server that lets AI agents and assistants interact with your Postman account—managing collections, requests, environments, workspaces, and API specifications through natural language.
It is officially built and hosted by Postman. The remote server runs over streamable HTTP at https://mcp.postman.com/mcp (the full configuration) and authenticates with OAuth, so you can connect a client without manually creating or pasting an API key. Postman also publishes lighter minimal and code endpoints, an EU-region host, and—for self-hosted setups—a local server you can run via npx @postman/postman-mcp-server or Docker (the local and EU servers use a Postman API key instead of OAuth).
Once connected, an agent can keep code in sync with collections and specs, create and tag collections, update documentation, manage workspaces and environment variables, and generate API specs—without leaving your editor. The full configuration exposes 100+ tools mapped to the Postman API.
Connect the Postman MCP server
Claude Code (remote, OAuth)
- 1
Add the server
Run: claude mcp add --transport http postman https://mcp.postman.com/mcp
- 2
Authorize with OAuth
On first use Claude opens a browser to sign in to Postman and approve access—no API key needed.
- 3
Verify
Run /mcp in Claude Code to confirm the Postman server is connected, then ask it to list your workspaces.
Cursor (remote, OAuth)
- 1
Open MCP settings
In Cursor go to Settings > MCP (or edit ~/.cursor/mcp.json).
- 2
Add the Postman server
Add an entry with url "https://mcp.postman.com/mcp" using the streamable HTTP transport.
- 3
Sign in
Cursor triggers the Postman OAuth flow in your browser; approve it to finish connecting.
- 4
Test it
Ask Cursor to fetch your Postman collections to confirm the tools are available.
Sample use cases
Keep an API spec and its Postman collection in sync from your editor
The agent updates collections or generates a spec without manual copy-paste.
Bulk-update collection and request documentation on a schedule
Docs stay current automatically as part of an automated run.
Provision a new workspace and environment variables for a project
Standardized Postman setup created via natural-language commands.
Security & permissions
The remote US server at https://mcp.postman.com/mcp uses OAuth: you authorize the connection through your Postman account, and the agent acts with your account's permissions over the Postman API—reading and writing your workspaces, collections, environments, and specs. No API key is pasted into the client. The EU remote server and the local/self-hosted server instead authenticate with a Postman API key, which carries the same account-level access and should be stored as a secret. Grant the agent only the access it needs and review which tool configuration (minimal, code, or full) you expose.
Using Postman MCP with Gamut
In a Gamut agent workflow, Postman is wired in as a connected MCP tool, with Gamut managing the OAuth connection to https://mcp.postman.com/mcp. An event- or schedule-triggered agent can then act on your Postman workspace as part of an automated run—for example, on a push or on a nightly schedule it can update a collection's documentation, sync a spec, or create an environment. The agent only does what its prompt and the server's tools allow; Gamut handles the connection and credentials so you don't hand-manage tokens per run.
Frequently asked questions
What is the Postman MCP server?
It is an official Model Context Protocol server, built by Postman, that lets AI agents like Claude and Cursor manage your Postman collections, requests, environments, workspaces, and API specs through the Postman API.
Is the Postman MCP server free?
The MCP server itself is free to use. You need a Postman account to authenticate, and Postman offers a Free plan along with paid Solo, Team, and Enterprise tiers.
How do I connect the Postman MCP server to Claude or Cursor?
Point your client at the remote server URL https://mcp.postman.com/mcp over streamable HTTP and complete the OAuth sign-in with Postman. In Claude Code use 'claude mcp add --transport http postman https://mcp.postman.com/mcp'; in Cursor add the URL under Settings > MCP.
Is the Postman MCP server hosted or self-hosted?
Both. Postman hosts the remote server at https://mcp.postman.com (OAuth, with an EU region option), and you can also self-host it locally via 'npx @postman/postman-mcp-server' or Docker using a Postman API key.