PluginBench
MCP Server
Active
Apache-2.0

Postman MCP Server MCP Server

com.postman/postman-mcp-server

Connect AI agents to Postman workspaces, collections, and APIs with 100+ tools across multiple configurations.

What is the Postman MCP Server MCP server?

The Postman MCP Server implements the Model Context Protocol to connect AI agents and coding assistants—including Claude, Cursor, VS Code Copilot, and GitHub Copilot CLI—directly to your Postman workspaces, collections, specifications, and environments. It offers four configurations (Minimal, Code, Full, Learn) with 100+ tools for API testing, code generation, collection management, and workspace automation.

The Postman MCP Server bridges AI agents with the full Postman platform, enabling automated API testing, client code generation, collection management, and workspace administration. Choose from Minimal (essential operations), Code (API consumption and code generation), Full (100+ advanced tools), or Learn (Postman documentation search) configurations. Supports both remote (OAuth) and local (API key) deployment across Claude, Cursor, VS Code, GitHub Copilot, and other agents.

How to install Postman MCP Server

Copy-paste configuration for popular MCP clients.

transport: stdio
Config generated by PluginBench — verify against the source before use.
Environment / auth
  • POSTMAN_API_KEY
    required
    secret

    A valid Postman API key.

  • Authorization
    required
    secret

    A Bearer token and a valid Postman API key for authentication.

~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "postman-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@postman/postman-mcp-server"
      ],
      "env": {
        "POSTMAN_API_KEY": "<YOUR_POSTMAN_API_KEY>",
        "Authorization": "<YOUR_AUTHORIZATION>"
      }
    }
  }
}

Tools & capabilities

Tools this server exposes to the agent.

  • Collection management — Create, update, and manage Postman collections and documentation
  • Workspace management — Create and manage workspaces and environment variables
  • API testing — Run and test APIs using Postman collections
  • Code generation — Generate production-ready client code from API definitions
  • Specification management — Create and manage API specifications
  • Documentation search — Search Postman Docs for guides, tutorials, and reference content (Learn configuration)

Use cases

  • Continuously test APIs using Postman collections without leaving your editor
  • Generate production-ready client code from public and internal API definitions
  • Create and manage collections, workspaces, and environments programmatically
  • Keep code synchronized with Postman Collections and API specifications
  • Automate API spec creation from code and generate collections from specs
  • Search Postman documentation and learning resources to discover features and API concepts

Postman MCP Server MCP server FAQ

What is the Postman MCP Server?

It's an MCP server that gives AI agents like Claude, Cursor, and VS Code Copilot direct access to your Postman workspaces, collections, APIs, and specifications. It offers 100+ tools across four configurations: Minimal (basic operations), Code (code generation), Full (all tools), and Learn (documentation search).

Is it free?

Yes, the Postman MCP Server is free and available as an npm package or via remote/local deployment. You need a Postman account and API key (or OAuth for remote servers).

How do I install it in Cursor or Claude?

For remote setup: add `https://mcp.postman.com/minimal` (or `/code`, `/mcp` for other modes) to your MCP host configuration. For local setup: run `npx @postman/postman-mcp-server` and set your `POSTMAN_API_KEY` environment variable. See Postman's MCP Server docs for IDE-specific instructions.

What authentication does it require?

The remote server at `https://mcp.postman.com` uses OAuth (no manual configuration needed). The EU remote server and local server require a Postman API key. OAuth is fully compliant with the MCP Authorization specification.

What are the different configurations?

Minimal (default, essential tools), Code (API consumption and code generation), Full (100+ tools for advanced collaboration), and Learn (searches Postman Docs for guides and tutorials).

Does it support EU regions?

Yes. The EU remote server is available at `https://mcp.eu.postman.com/mcp` (Full), `/code`, and `/minimal`. Use the `--region eu` flag for local deployment or set `POSTMAN_API_BASE_URL` directly. EU server requires API key authentication.

README (reference)

Source of truth, from the repository.

Postman MCP Server

The 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 your Postman workspaces, collections, specifications, and environments.

Postman also offers the server as an npm package.

For the full installation guide with agent-specific setup, see Postman's MCP Server product page.


Postman MCP Server collection

The Postman MCP Server collection is the quickest way to explore, test, and connect to the Postman MCP Server. Use it to:

  • Browse the complete list of available tools across all configurations.
  • Connect to and test the remote server — Full and Minimal.
  • Connect to and test the local server.

Tool configurations

  • Minimal — (Default) Only includes essential tools for basic Postman operations. Ideal for users who want to modify a single Postman element, such as collections, workspaces, or environments.
  • Code — Includes tools to generate high-quality, well-organized client code from public and internal API definitions. Ideal for users who need to consume APIs or get API context to their agents.
  • Full — Includes all available Postman API tools (100+ tools). Ideal for users who engage in advanced collaboration and Postman's Enterprise features.
  • Learn — Searches Postman Docs for guides, tutorials, and reference content. Ideal for agents who need to discover Postman features, look up API concepts, or find learning resources.

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.


Supported agents and IDEs

Agent / IDERemoteLocal
Claude CodeDocsDocs
Claude DesktopDocsDocs
CursorDocsDocs
VS CodeDocsDocs
CodexDocsDocs
Antigravity CLIDocsDocs
GitHub Copilot CLIDocsDocs
KiroDocsDocs
Docker—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.

Use cases

  • API Testing — Continuously test your API using your Postman collection. Use the local server to test local APIs, as the remote server won't have network access to your workstation.
  • Code synchronization — Keep your code in sync with your 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.

Docker

For Docker setup and installation, see DOCKER.md.


Contributing

Bug reports, tool requests, and documentation fixes are all welcome — see CONTRIBUTING.md.

The MCP tool definitions and the server implementation here are synced from Postman's internal source of truth, so changes to files under src/ can't be merged in this repository — but issues are how those changes get made, and we credit contributions that ship. Documentation and repository tooling accept pull requests directly.

Found a security issue? See SECURITY.md — please don't open a public issue.


Questions and support


Keywords

Model Context Protocol · MCP Server · Postman · AI Agents · Claude Code · Cursor · VS Code · Specifications · REST API · API Testing · TypeScript · OpenAPI

Related MCP servers

Schedule social media posts to 10 platforms: Instagram, TikTok, X, YouTube, LinkedIn, and more

Stock trades of U.S. Congress & executive-branch officials, with conflict flags. Read-only.

PotterySuppliesHQ: the site's own MCP server — dataset, enquiry (enquiry = a human handoff, not...

View repository →

Remote MCP server bridging AI clients with the PowerDMARC email authentication Platform.

Indian electricity tariff and bill-verification MCP with fail-closed regulatory execution.

Upload AI-written HTML presentations and manage expiring, revocable share links over OAuth.