
Postman MCP Server
Your Postman workspaces, collections, specs and mocks, from inside the editor.
- Needs your setup first
- ★ 325 GitHub stars
- 9.4K downloads a week
- Last commit 23 Oct 2026
What is Postman MCP Server?
Postman MCP Server is Postman's official server that lets a coding agent work with your Postman workspaces, collections, specs, environments and mocks, and write client code from them.
- Tools
- 42
- Runs on
- Hosted
- Licence
- Apache-2.0
- GitHub stars
- 325
Good for
- Keeping a Postman collection in step with the API code you are changing
- Turning an OpenAPI spec into a collection, or a collection into a spec
- Generating a typed API client from requests your team already keeps in Postman
You'll need
- A Postman account (OAuth on the US hosted server) or a Postman API key
- Node.js 20 or newer for the local package
Needs your setup firstIt needs something our Linux test machine does not have (an account, a desktop app, a Mac or a running service), so on 10 Nov 2026 we read its tools from the source code instead of running this config. The shared database pointed at the Full URL with an API key header. Postman recommends OAuth on the Minimal endpoint as the place to start, so this page uses that.
Try asking Postman MCP Server
Once it is installed, ask your assistant things like:
- List the collections in my workspace.
- Create a collection for our users API with requests for each endpoint.
- Set up a mock server for the orders collection.
MCP Shelf take
Postman needs something our Linux test machine does not have (an account, an app or a service), so on 10 Nov 2026 we read its source and counted 42 tools. 20 of the 42 only read; the other 22 can change things. It sits 24th of 24 in its category on our shelf by GitHub stars (325, with 9.4K downloads a week).
What can Postman MCP Server read and change?
It can read
- Your workspaces, collections, requests, environments and their variables
- API specs, mock servers, tags and your Postman user details
- Postman's documentation, in Learn mode
It can change
- Collections, requests, environments, specs and workspaces, including replacing them
- Mock servers, including making one public
- Runs collections, which send real requests to the APIs they call
Safer setup: Start with Minimal, and use a Postman API key from an account or team that only has the workspaces you want touched. Ask the agent to show you a change before it calls putCollection or putEnvironment, which replace the whole thing.
Postman MCP Server in more detail
Postman maintains this server, which connects a coding agent to your Postman account. It can read and create collections, requests and environments, keep a collection and an OpenAPI spec in sync in either direction, generate a collection from a spec, run a collection, and publish a mock server. A separate Code mode pulls a request's full context so the agent can write client code against an API you have in Postman.
You choose how much to load. Minimal, the default, has about 40 tools for everyday edits; Full exposes the whole Postman API with over 200; Code is for generating client code; Learn only searches the Postman docs. The hosted server signs in with OAuth, and a local npx package takes an API key.
- Made by
- Postman (postmanlabs/postman-mcp-server)
- Downloads
- 9.4K a week
- Last commit
- 23 Oct 2026
- Setup checked
- 10 Nov 2026
- Page updated
- 10 Nov 2026
What's in the pod
What tools does Postman MCP Server have?
We found 42 tools in its source code on 10 Nov 2026. 20 only read. The rest can change things, so keep your app's "ask before each tool call" setting on for them.
How we tested it: Read from @postman/postman-mcp-server 2.15.0, which defines the same Minimal tool set as the hosted /minimal URL. The hosted server needs a Postman sign-in.
Changes things22 tools · Can create, edit, send or delete.
| Tool | What it is for |
|---|---|
createCollection | Creates a collection in a workspace. |
createCollectionRequest | Adds a request to a collection or folder. |
createCollectionResponse | Saves an example response on a request. |
createEnvironment | Creates an environment with variables. |
createMock | Creates a mock server from a collection. |
createSpec | Creates a spec from an OpenAPI or AsyncAPI definition. |
createSpecFile | Adds a file to a spec. |
createWorkspace | Creates a workspace. |
duplicateCollection | Copies a collection into another workspace, as a background task. |
generateCollection | Generates a collection from a spec. |
generateSpecFromCollection | Generates an OpenAPI spec from a collection. |
publishMock | Makes a mock server public so anyone with the URL can call it. |
putCollection | Replaces a collection with a new version. |
putEnvironment | Replaces an environment's variables. |
runCollection | Runs a collection's requests and tests and returns the results. |
syncCollectionWithSpec | Updates a generated collection to match its spec after the spec changes. |
syncSpecWithCollection | Updates a spec to match changes made in its collection. |
updateCollectionRequest | Changes a request's method, URL, headers, body or scripts. |
updateMock | Changes a mock server's settings. |
updateSpecFile | Changes the content of a spec file. |
updateSpecProperties | Renames a spec or changes its description. |
updateWorkspace | Renames a workspace or changes its description. |
Only reads20 tools · Looks things up and changes nothing.
| Tool | What it is for |
|---|---|
getAllSpecs | Lists the API specs in a workspace. |
getAuthenticatedUser | Shows which Postman user and team the session is signed in as. |
getCollection | Reads a whole collection, with its folders, requests and scripts. |
getCollections | Lists the collections in a workspace. |
getDuplicateCollectionTaskStatus | Checks whether a collection copy has finished. |
getEnabledTools | Lists which tools the Minimal and Full sets include, so the agent can find another way when a tool is missing. |
getEnvironment | Reads an environment and its variables. |
getEnvironments | Lists the environments in a workspace. |
getGeneratedCollectionSpecs | Shows which spec a generated collection came from. |
getMock | Reads one mock server. |
getMocks | Lists mock servers. |
getSpec | Reads a spec's details. |
getSpecCollections | Lists the collections generated from a spec. |
getSpecDefinition | Returns a spec's full OpenAPI or AsyncAPI definition. |
getSpecFile | Reads one spec file. |
getSpecFiles | Lists the files that make up a multi-file spec. |
getTaggedEntities | Finds the collections, workspaces and APIs that carry a tag. |
getWorkspace | Reads one workspace, with the collections, environments, specs and mocks in it. |
getWorkspaces | Lists the workspaces you can see. |
searchPostmanElements | Searches Postman for workspaces, collections and requests by name. |
Tool groups
Minimal (default, /minimal)- About 40 tools: workspaces, collections, requests and example responses, environments, specs and spec files, generating and syncing collections and specs, mocks, tags, search and collection runs.
Code (/code or --code)- About 20 tools that gather a request's or an API's full context, such as its definition, auth, variables and examples, so the agent can generate client code in your project's style.
Full (/mcp or --full)- The whole Postman API, over 200 tools, including comments, forks, pull requests, monitors, API governance and Enterprise features.
Learn- searchLearningCenter alone, which searches Postman's docs, guides and tutorials.
Grouped and described by us. The README on GitHub lists the inputs each tool takes.
How do I install Postman MCP Server?
Quick install
Pick your app and paste this in. It follows the README's own install steps below.
Where it goes: Your terminal, in the project folder
claude mcp add --transport http postman https://mcp.postman.com/minimalclaude mcp add --transport http postman https://mcp.postman.com/minimal, then /mcp to sign in to Postman. Use /code or /mcp at the end of the URL for the other modes.
Where it goes: ~/.cursor/mcp.json, or .cursor/mcp.json in a project
{
"mcpServers": {
"postman": {
"url": "https://mcp.postman.com/minimal"
}
}
}Where it goes: Customize → Connectors → add a custom connector
https://mcp.postman.com/minimalAdd the URL as a custom connector and sign in to Postman when asked. For the local package, use npx @postman/postman-mcp-server with POSTMAN_API_KEY in env.
Where it goes: .vscode/mcp.json in your project
{
"servers": {
"postman": {
"type": "http",
"url": "https://mcp.postman.com/minimal"
}
}
}Install steps from the Postman MCP Server README
The project's own instructions, copied from its README on GitHub on 10 Nov 2026 under its Apache-2.0 licence. They are the source of truth; the ready-made configs further down are built from them. The full README is on GitHub.
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:
https://mcp.postman.com/minimal
Change /minimal to /code or /mcp for Code or Full mode. For EU or API key auth, pass Authorization: Bearer <POSTMAN_API_KEY> as a header.
Local:
npx @postman/postman-mcp-server
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.
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, andhttps://mcp.eu.postman.com/minimal. - For the STDIO public package, use the
--region euflag, or set thePOSTMAN_API_BASE_URLenvironment variable directly. - OAuth isn't supported for the EU server. The EU remote server only supports API key authentication.
What you need first
- A Postman account (OAuth on the US hosted server) or a Postman API key
- Node.js 20 or newer for the local package
Add Postman MCP Server to your app
Pick your app for a ready-to-paste snippet and where it goes, built from the steps above.
Where it goes: Your terminal, in the project folder
claude mcp add --transport http postman https://mcp.postman.com/minimalclaude mcp add --transport http postman https://mcp.postman.com/minimal, then /mcp to sign in to Postman. Use /code or /mcp at the end of the URL for the other modes.
Where it goes: ~/.cursor/mcp.json, or .cursor/mcp.json in a project
{
"mcpServers": {
"postman": {
"url": "https://mcp.postman.com/minimal"
}
}
}Where it goes: Customize → Connectors → add a custom connector
https://mcp.postman.com/minimalAdd the URL as a custom connector and sign in to Postman when asked. For the local package, use npx @postman/postman-mcp-server with POSTMAN_API_KEY in env.
Where it goes: .vscode/mcp.json in your project
{
"servers": {
"postman": {
"type": "http",
"url": "https://mcp.postman.com/minimal"
}
}
}Where it goes: ~/.codex/config.toml, shared by the Codex CLI, IDE extension and ChatGPT desktop app
[mcp_servers.postman]
url = "https://mcp.postman.com/minimal"Or run: codex mcp add postman --url https://mcp.postman.com/minimal, then codex mcp login postman if it asks you to sign in.
Where it goes: ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"postman": {
"serverUrl": "https://mcp.postman.com/minimal"
}
}
}Where it goes: chatgpt.com/plugins → + → Add custom MCP server
https://mcp.postman.com/minimalPaste the URL as the server address, choose OAuth if it asks you to sign in, create it as a plugin, then install it before using it in a chat. Workspace admins can block custom servers.
Swap /minimal for /code or /mcp to get Code or Full mode. The EU server, https://mcp.eu.postman.com/minimal, needs an Authorization: Bearer header with your API key instead of OAuth.
Checked against the project's own install docs on 10 Nov 2026: postmanlabs/postman-mcp-server README, learning.postman.com/docs/reference/postman-api/postman-mcp-server/overview, www.npmjs.com/package/@postman/postman-mcp-server.
Did this work for you?
Projects change their install steps often. If Postman MCP Server did not install, or something here no longer matches the project, tell us and we will check it against the README and fix the page.
New to this? See the setup guides for Claude Code, Cursor, Claude Desktop, VS Code, Codex and ChatGPT. If it will not start, test it in MCP Inspector and look up the error in Fixing MCP server errors.
Postman MCP Server not working? Common fixes
- OAuth fails on the EU server
- The EU server has no OAuth. Send your Postman API key in an Authorization: Bearer header, or use the US server if your team is not on the EU data region.
- A collection run cannot reach my local API
- The hosted server runs in Postman's cloud and cannot see localhost. Use the local npx package to test APIs on your own machine.
- The tool I need is missing
- Minimal leaves most of the Postman API out. Switch the URL to /mcp, or add --full to the local package, for every tool, or ask the agent to call getEnabledTools to see where it lives.
- The model is slow or picks the wrong tool in Full mode
- Full loads over 200 tools. Go back to Minimal, or Code if you are generating client code, unless you need the Enterprise features.
- The local server will not start
- It needs Node.js 20 or newer and POSTMAN_API_KEY in its env. Create a key under your Postman account settings, API keys.
How do I configure Postman MCP Server?
Names are exactly as the project spells them. Required ones are marked.
| Setting | What it does |
|---|---|
https://mcp.postman.com/minimalConfig | The US hosted server in Minimal mode. It signs in with OAuth, so no key is needed. Use /code or /mcp at the end for Code or Full. |
Authorization: BearerConfig | Header carrying a Postman API key, for the EU server or a client that cannot do OAuth.Authorization: Bearer PMAK-your-key |
https://mcp.eu.postman.com/minimalConfig | The EU hosted server, also at /code and /mcp. It accepts only an API key, not OAuth. |
POSTMAN_API_KEYEnvironment variable | Your Postman API key for the local npx @postman/postman-mcp-server package. |
--code, --full and --region euCommand line flag | Flags for the local package: pick Code or Full mode instead of Minimal, and point it at Postman's EU region (or set POSTMAN_API_BASE_URL).npx @postman/postman-mcp-server --full --region eu |
Postman MCP Server FAQ
Is the Postman MCP Server official?
Yes. Postman builds it in the postmanlabs organisation on GitHub, runs the hosted server at mcp.postman.com and publishes the local version as @postman/postman-mcp-server on npm, under Apache-2.0.
Which mode should I pick: Minimal, Code or Full?
Minimal, the default, covers everyday work on collections, environments, specs and mocks. Code is for generating client code from APIs in Postman. Full adds the rest of the Postman API, over 200 tools.
Do I need a Postman API key?
Not on the US hosted server, which signs in with OAuth. The EU server and the local npx package only take an API key, sent as a Bearer header or set as POSTMAN_API_KEY.
How do I add the Postman MCP Server to Cursor or VS Code?
Add https://mcp.postman.com/minimal as a remote server and sign in when the editor opens Postman's login. Postman's docs have a page for each editor, including Codex, Kiro and GitHub Copilot CLI.
Can it keep my OpenAPI spec and collection in sync?
Yes. generateCollection builds a collection from a spec, and syncCollectionWithSpec and syncSpecWithCollection update one after the other has changed, in either direction.
Can the agent run my API tests?
Yes, runCollection runs a collection and its test scripts. The hosted server cannot reach localhost, so use the local package for APIs that only run on your machine.
Does it work in Postman's EU region?
Yes. Use mcp.eu.postman.com with an API key, or pass --region eu to the local package. OAuth is only available on the US server.
What does it cost?
The server is free to use with any Postman account. What you can reach depends on your Postman plan, so Enterprise features in Full mode need an Enterprise team.
Does Postman MCP Server work with Codex?
Yes. Run codex mcp add postman --url https://mcp.postman.com/minimal in a terminal, or add an [mcp_servers.postman] table to ~/.codex/config.toml, which the Codex CLI and IDE extension share. Then codex mcp login postman if it asks you to sign in.
Two peas, one chat
Chat with AI about Postman
Opens a chat primed with Postman’s README and setup docs from this page, or add it in Cursor to use its tools.
The Cursor button opens Cursor and asks before it adds the server. Fill in any keys it needs in Cursor’s MCP settings.
Peas in a pod
What are the alternatives to Postman MCP Server?
How Postman MCP Server lines up against its neighbours on the shelf. See every developer tools server.

Postman MCP ServerThis pea
Your Postman workspaces, collections, specs and mocks, from inside the editor.
- Tools
- 42
- Runs on
- Hosted
- Licence
- Apache-2.0
- Stars
- 325

A terminal, file search and surgical file edits for your assistant.
- Tools
- 25
- Runs on
- Your computer
- Licence
- MIT
- Stars
- 10.2K

IDE-style "find symbol" and "edit symbol" for an agent, backed by language servers.
- Tools
- 3 (REPL)
- Runs on
- Your computer
- Licence
- GPL-3.0
- Stars
- 30.8K

Pulls current, version-specific library docs into the conversation.
- Tools
- 2
- Runs on
- Your computer or hosted
- Licence
- MIT
- Stars
- 63.8K

GitHub's own server for repos, issues, pull requests and Actions.
- Tools
- 46
- Runs on
- Hosted or your computer
- Licence
- MIT
- Stars
- 34K
The official debugging UI for MCP servers. Not a server you add to a client.
- Tools
- Test client
- Runs on
- Your computer
- Licence
- MIT / Apache-2.0
- Stars
- 11.2K
Something wrong on this page? Tell us.
For bots & AI agents
Machine-readable versions of Postman MCP Server and MCP Shelf. Fetch these instead of parsing this page.
This listing (.md)llms.txtllms-full.txtai.txtFull catalog (.md)API specMCP serverMCP manifestDeveloper docs