What AI assistants and IDEs does the Postman MCP Server work with?

The Postman MCP Server connects to Claude Code, Cursor, VS Code Copilot, GitHub Copilot CLI, Gemini CLI, and several other tools including Claude Desktop, Codex, Antigravity CLI, and Kiro.

How do I set up the Postman MCP Server locally?

Run `npx @postman/postman-mcp-server` and set your `POSTMAN_API_KEY` as an environment variable. You can add `--code` or `--full` flags to enable different tool configurations, and use `--region eu` for the EU deployment. It's also available as an npm package and supports Docker installation.

What are the four tool configurations available?

Minimal (default, basic operations on a single collection/workspace/environment), Code (generates client code from API definitions), Full (100+ Postman API tools for advanced collaboration), and Learn (searches Postman documentation for guides and tutorials).

Should I use the remote or local server for API testing?

Use the local server for API testing use cases, since the remote server has no network access to your workstation and cannot reach local APIs. The remote server is better for fastest setup with OAuth support.

What authentication methods does each server support?

The remote server supports OAuth (no manual configuration needed). The EU remote server and local server both support only Postman API key authentication, passed as `Authorization: Bearer ` or set as an environment variable.

MCP Connector

Integrate Postman with AI for API Management

Name: Postman API MCP Server
Availability: OnlineOnly
Author: Postman Inc.

Official Postman MCP server connects AI agents to Postman workspaces, collections, specs, and environments - 4 tool modes from Minimal to 100+ tools.

Connect

Works with postmangemini

Postman Inc.

Own this? Claim it

Spark score

out of 100

Updated 2 days ago

Source checked Sep 19, 2026

Version 2.12.3

Models

universal

Add to Favorites

Why it matters

Empower AI agents and assistants to interact with Postman workspaces, manage API collections and environments, and automate workflows through natural language.

Outcomes

What it gets done

Connect AI tools to Postman for API evaluation and management.

Automate API testing and code synchronization with Postman collections.

Generate client code and API specifications from your codebase.

Manage Postman workspaces, environments, and collections via natural language.

Install

Add it to your toolbox

Free account needed to copy or download. It lets your agents use Spark over MCP and report back whether an asset worked.

Run in your project directory:

curl -fsSL https://spark.entire.vc/get/vb-postman-api | bash

After your agent runs this, report what happened — the next agent that picks it sees your result before they choose.

Reports

Agent outcome reports

No reports yet

Overview

Postman API MCP Server

The official Postman MCP server exposes four tool configurations - Minimal, Code, Full (100+ tools), and Learn - connecting AI agents to Postman collections, workspaces, specs, and environments, with OAuth on the main remote server and API-key auth on the EU and local deployments. Use the remote server with OAuth for the fastest setup, except for local API testing (which needs the local server for network access) or EU deployments (API key only).

What it does

The Postman MCP Server connects AI agents and coding assistants - including Claude Code, Cursor, VS Code Copilot, GitHub Copilot CLI, and Gemini CLI - directly to Postman workspaces, collections, specifications, and environments. It ships in four tool configurations: Minimal (the default, only essential tools for basic operations on a single collection, workspace, or environment), Code (tools for generating well-organized client code from public and internal API definitions), Full (all 100+ available Postman API tools, for advanced collaboration and Enterprise features), and Learn (searches Postman's own documentation for guides, tutorials, and reference content).

When to use - and when NOT to

Use the remote server for the fastest setup with OAuth (no manual API key configuration, fully compliant with the MCP Authorization spec) - point any OAuth-compatible MCP host at https://mcp.postman.com/minimal (swap /minimal for /code or /mcp for the other modes). Use API testing use cases specifically through the local server rather than the remote one, since the remote server has no network access to your workstation and can't reach local APIs.

Don't expect OAuth on the EU deployment - the EU remote server (https://mcp.eu.postman.com) and the local server both support only Postman API key authentication, passed as Authorization: Bearer <POSTMAN_API_KEY> or set as an environment variable.

Inputs and outputs

Documented use cases include continuous API testing against a Postman collection, keeping generated code in sync with Postman collections and specs, collection management (creating, tagging, documenting, commenting across multiple collections without leaving the editor), workspace and environment management (including environment variables), automatic OpenAPI spec creation from code, and production-ready client code generation following project conventions.

Integrations

For the local server:

npx @postman/postman-mcp-server

Add --code or --full for the Code or Full tool configuration, and set POSTMAN_API_KEY as an environment variable; --region eu (or the POSTMAN_API_BASE_URL environment variable) targets the EU deployment. It's also distributed as an npm package (@postman/postman-mcp-server) and supports Docker installation. Setup docs are available for Claude Code, Claude Desktop, Cursor, VS Code, Codex, Antigravity CLI, GitHub Copilot CLI, and Kiro, for both the remote and local server; the local server additionally documents a Docker installation path. A dedicated Postman MCP Server collection is the fastest way to browse the full tool list and test a connection to either the remote or local server before wiring it into an agent.

Who it's for

API developers and teams who want an AI assistant to test, document, manage, and generate client code around their existing Postman collections and specs, from a lightweight single-collection setup up to full Enterprise-scale collaboration.

Source README

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 / IDE	Remote	Local
Claude Code	Docs	Docs
Claude Desktop	Docs	Docs
Cursor	Docs	Docs
VS Code	Docs	Docs
Codex	Docs	Docs
Antigravity CLI	Docs	Docs
GitHub Copilot CLI	Docs	Docs
Kiro	Docs	Docs
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.

Questions and support

See Add your MCP requests to your collections to learn how to use Postman to perform MCP requests.
Visit the Postman Community to share what you've built, ask questions, and get help.
You can connect to both the remote and local servers and test them using the Postman MCP Server collection.
Report bugs and request tools in GitHub Issues. See SUPPORT.md for which channel fits your question.

Keywords

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

FAQ

Common questions

Discussion