Skip to content
MCP Shelf

Postman MCP Server

Your Postman workspaces, collections, specs and mocks, from inside the editor.

View on GitHub
  • 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
Works withClaude CodeCursorClaude DesktopVS CodeCodexWindsurfChatGPTEach has a ready-made config on the Install tab, built from the README.

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).
MCP Shelf tests: numbers from our own runs, not the README · tested on 10 Nov 2026

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.

ToolWhat it is for
createCollectionCreates a collection in a workspace.
createCollectionRequestAdds a request to a collection or folder.
createCollectionResponseSaves an example response on a request.
createEnvironmentCreates an environment with variables.
createMockCreates a mock server from a collection.
createSpecCreates a spec from an OpenAPI or AsyncAPI definition.
createSpecFileAdds a file to a spec.
createWorkspaceCreates a workspace.
duplicateCollectionCopies a collection into another workspace, as a background task.
generateCollectionGenerates a collection from a spec.
generateSpecFromCollectionGenerates an OpenAPI spec from a collection.
publishMockMakes a mock server public so anyone with the URL can call it.
putCollectionReplaces a collection with a new version.
putEnvironmentReplaces an environment's variables.
runCollectionRuns a collection's requests and tests and returns the results.
syncCollectionWithSpecUpdates a generated collection to match its spec after the spec changes.
syncSpecWithCollectionUpdates a spec to match changes made in its collection.
updateCollectionRequestChanges a request's method, URL, headers, body or scripts.
updateMockChanges a mock server's settings.
updateSpecFileChanges the content of a spec file.
updateSpecPropertiesRenames a spec or changes its description.
updateWorkspaceRenames a workspace or changes its description.

Only reads20 tools · Looks things up and changes nothing.

ToolWhat it is for
getAllSpecsLists the API specs in a workspace.
getAuthenticatedUserShows which Postman user and team the session is signed in as.
getCollectionReads a whole collection, with its folders, requests and scripts.
getCollectionsLists the collections in a workspace.
getDuplicateCollectionTaskStatusChecks whether a collection copy has finished.
getEnabledToolsLists which tools the Minimal and Full sets include, so the agent can find another way when a tool is missing.
getEnvironmentReads an environment and its variables.
getEnvironmentsLists the environments in a workspace.
getGeneratedCollectionSpecsShows which spec a generated collection came from.
getMockReads one mock server.
getMocksLists mock servers.
getSpecReads a spec's details.
getSpecCollectionsLists the collections generated from a spec.
getSpecDefinitionReturns a spec's full OpenAPI or AsyncAPI definition.
getSpecFileReads one spec file.
getSpecFilesLists the files that make up a multi-file spec.
getTaggedEntitiesFinds the collections, workspaces and APIs that carry a tag.
getWorkspaceReads one workspace, with the collections, environments, specs and mocks in it.
getWorkspacesLists the workspaces you can see.
searchPostmanElementsSearches 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 Code
claude mcp add --transport http postman https://mcp.postman.com/minimal

claude 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.

Codex, Windsurf, ChatGPT and more →

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, 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.

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 Code
claude mcp add --transport http postman https://mcp.postman.com/minimal

claude 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.

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.

SettingWhat it does
https://mcp.postman.com/minimalConfigThe 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: BearerConfigHeader 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/minimalConfigThe EU hosted server, also at /code and /mcp. It accepts only an API key, not OAuth.
POSTMAN_API_KEYEnvironment variableYour Postman API key for the local npx @postman/postman-mcp-server package.
--code, --full and --region euCommand line flagFlags 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
  • Desktop Commander

    A terminal, file search and surgical file edits for your assistant.

    Tools
    25
    Runs on
    Your computer
    Licence
    MIT
    Stars
    10.2K
  • Serena

    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
  • Context7

    Pulls current, version-specific library docs into the conversation.

    Tools
    2
    Runs on
    Your computer or hosted
    Licence
    MIT
    Stars
    63.8K
  • GitHub

    GitHub's own server for repos, issues, pull requests and Actions.

    Tools
    46
    Runs on
    Hosted or your computer
    Licence
    MIT
    Stars
    34K
  • MCP Inspector

    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
Full docs on GitHubpostmanlabs/postman-mcp-server

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