Skip to main content
Watch: I Built an AI App Without Leaving Databricks

Developer platforms - official Postman server

Postman MCP server

Connects AI agents to Postman workspaces, collections, specifications, environments, mocks and monitors through the Postman API. Offered as a hosted remote server with Minimal, Code, Full, Learn and Context Graph tool configurations, or as a local STDIO server via npm or Docker. Postman hosts it at https://mcp.postman.com/minimal, or you can run @postman/postman-mcp-server (npm) locally with OAuth or API key auth.

Last verified 14 tools8 sources

Install

Terminal
claude mcp add --transport http postman https://mcp.postman.com/minimal
Terminal
codex mcp add postman --url https://mcp.postman.com/minimal
JSON
{
    "mcpServers": {
        "postman": {
            "url": "https://mcp.postman.com/minimal"
        }
    }
}

VS Code

JSON
{
    "servers": {
        "postman": {
            "type": "http",
            "url": "https://mcp.postman.com/minimal"
        }
    }
}

Generic

Terminal
npx @postman/postman-mcp-server

Tools

getWorkspaces
Gets all workspaces you have access to.
createWorkspace
Creates a new workspace.
getCollections
Lists collections in a workspace (workspace ID required).
createCollection
Creates a collection using the Postman Collection v2.1.0 schema format.
putCollection
Replaces the contents of a collection using the Postman Collection v2.1.0 schema format.
runCollection
Runs a Postman collection by ID with detailed test results and execution statistics.
createEnvironment
Creates an environment.
getEnvironments
Gets information about all of your environments.
createSpec
Creates an API specification in Postman's Spec Hub (single or multi-file).
getAllSpecs
Gets all API specifications in a workspace.
generateCollection
Creates a collection from the given API specification.
syncCollectionWithSpec
Syncs a collection generated from an API specification.
createMock
Creates a mock server in a collection.
publishMock
Publishes a mock server, setting its access control to public.

As documented on October 17, 2026. A running server reports its current list through tools/list.

Notes and caveats

  • Remote endpoints by configuration: /minimal (default), /code, /mcp (Full, 100+ tools), /learn, /context-graph.
  • EU region at https://mcp.eu.postman.com/* supports API key auth only (no OAuth); local server also requires a POSTMAN_API_KEY (use --region eu for EU).
  • Context Graph requires Context Graph enabled for the team.
  • Remote server collects anonymous telemetry by default; local server is opt-in.
  • Docs list the full tool catalog only in a Postman collection; tool names above come from the official repo source (Minimal configuration).
  • Docs carry no beta or preview label.
  • Latest release v2.14.0 (npm, 2026-10-16).
  • Postman recommends its CLI and agent skills over MCP for coding agents working in a repository.

FAQ

What does the Postman MCP server do?

Connects AI agents to Postman workspaces, collections, specifications, environments, mocks and monitors through the Postman API. Offered as a hosted remote server with Minimal, Code, Full, Learn and Context Graph tool configurations, or as a local STDIO server via npm or Docker. The vendor documents 14 tools, including getWorkspaces, createWorkspace, getCollections and createCollection.

How do I add the Postman MCP server to Claude Code?

Run claude mcp add --transport http postman https://mcp.postman.com/minimal, copied from Postman's docs. This page also has snippets for Codex, Cursor, VS Code and Generic.

Does the Postman MCP server need authentication?

Yes, OAuth or API key. Transport: Streamable HTTP, stdio. Status: GA, last checked October 17, 2026.

Sources

Last verified against 8 Postman pages, then re-checked independently.

Newsletter

New MCP servers, the week they ship

One email per week. New official MCP servers, the coding tools that support them and how developers wire them up.