Postman
Bypostmanlabs·56
Postman's MCP server connects AI agents, assistants, and chatbots directly to your APIs on Postman. Use natural language to prompt AI to automate work across your Postman collections, environments, workspaces, and more.
The Postman MCP Server connects Postman to AI tools, giving AI agents and assistants the ability to access workspaces, manage collections and environments, evaluate APIs, and automate workflows through natural language interactions.
Postman supports the following tool configurations:
- Minimal — (Default) Only includes essential tools for basic Postman operations This offers faster performance and simplifies use for those who only need basic Postman operations. Ideal for users who want to modify a single Postman elements, such as collections, workspaces, or environments.
- Full — Includes all available Postman API tools (100+ tools). This configuration is ideal for users who engage in advanced collaboration and Postman's Enterprise features.
For a complete list of the Postman MCP Server's tools, see thePostman MCP Server collection. This collection offers both the remotefull andminimal servers, and thelocal server.
Postman also offers servers as annpm package.
Note: Before getting started, ensure that you have a validPostman API key.
- Code synchronization - Effortlessly keep your code in sync with yourPostman Collections and specs.
- Collection management - Create andtag collections, update collection and requestdocumentation, addcomments, or perform actions across multiple collections without leaving your editor.
- Workspace and environment management - Createworkspaces andenvironments, plus manage your environment variables.
- Automatic spec creation - Createspecs from your code and use them to generate collections.
Designed for developers who want to integrate their AI tools with Postman’s context and features. Supports quick natural language queries queries to advanced agent workflows.
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
. - For our STDIO public package, use the
--region
flag to specify the Postman API region (us
oreu
), or set thePOSTMAN_API_BASE_URL
environment variable directly.
The remote Postman MCP Server is hosted by Postman over streamable HTTP and provides the easiest method for getting started. If your MCP host doesn't support remote MCP servers, you can use thelocal Postman MCP Server.
The remote server supports the following tool configurations:
- Minimal — (Default) Only includes essential tools for basic Postman operations, available at
https://mcp.postman.com/minimal
andhttps://mcp.eu.postman.com/minimal
for EU users. - Full — Includes all available Postman API tools (100+ tools), available at
https://mcp.postman.com/mcp
andhttps://mcp.eu.postman.com/mcp
for EU users.
To install the remote Postman MCP Server in Cursor, click the install button.
Note: Ensure that the Authorization header uses theBearer <YOUR_API_KEY>
format.
By default, the server usesMinimal mode. To accessFull mode, change theurl
value tohttps://mcp.postman.com/mcp
in themcp.json
file.
To install the remote Postman MCP Server in VS Code, click the install button or use thePostman VS Code Extension.
By default, the server usesMinimal mode. To accessFull mode, change theurl
value tohttps://mcp.postman.com/mcp
in themcp.json
file.
You can use the Postman MCP Server with MCP-compatible extensions in VS Code, such as GitHub Copilot, Claude for VS Code, or other AI assistants that support MCP. To do so, add the following JSON block to the.vscode/mcp.json
configuration file:
{"servers": {"postman-api-http-server": {"type":"http","url":"https://mcp.postman.com/{minimal OR mcp}",// Use "https://mcp.postman.com/mcp" for full or "https://mcp.postman.com/minimal" for minimal mode.// For the EU server, use the "https://mcp.eu.postman.com" URL."headers": {"Authorization":"Bearer ${input:postman-api-key}" } } },"inputs": [ {"id":"postman-api-key","type":"promptString","description":"Enter your Postman API key" } ]}
When prompted, enter your Postman API key.
To install the MCP server in Claude Code, run the following command in your terminal:
ForMinimal mode:
claude mcp add --transport http postman https://mcp.postman.com/minimal
ForFull mode:
claude mcp add --transport http postman https://mcp.postman.com/mcp
If remote MCP servers aren't supported by your MCP host, you can install the Postman MCP Server to your local machine.
STDIO is a lightweight solution that's ideal for integration with editors and tools like Visual Studio Code. Install an MCP-compatible VS Code extension, such as GitHub Copilot, Claude for VS Code, or other AI assistants that support MCP.
Note: To run the server as a Node application, installNode.js.
The local server supports the following tool configurations:
- Minimal — (Default) Only includes essential tools for basic Postman operations.
- Full — Includes all available Postman API tools (100+ tools). Use the
--full
flag to enable this configuration.
Note: Use the--region
flag to specify the Postman API region (us
oreu
), or set thePOSTMAN_API_BASE_URL
environment variable directly. By default, the server uses theus
option.
To install the local Postman MCP Server in VS Code, click the install button.
By default, the server usesFull mode. To accessMinimal mode, remove the--full
flag from themcp.json
configuration file.
You can manually integrate your MCP server with Cursor or VS Code to use it with extensions that support MCP. To do this, create amcp.json
file in your project and add the following JSON block to it:
{"servers": {"postman-api-mcp": {"type":"stdio","command":"npx","args": ["@postman/postman-mcp-server","--full"// (optional) Use this flag to enable full mode."--region us"// (optional) Use this flag to specify the Postman API region (us or eu). Defaults to us. ],"env": {"POSTMAN_API_KEY":"${input:postman-api-key}" } } },"inputs": [ {"id":"postman-api-key","type":"promptString","description":"Enter your Postman API key" } ]}
To install the local Postman MCP Server in Cursor, click the install button.
By default, the server usesFull mode. To accessMinimal mode, remove the--full
flag from themcp.json
configuration file.
To integrate the MCP server with Claude, check the latestPostman MCP Server release and get the.mcpb
file.
- Minimal -
postman-api-mcp-minimal.mcpb
- Full -
postman-api-mcp-full.mcpb
For more information, see theClaude Desktop Extensions documentation.
To install the MCP server in Claude Code, run the following command in your terminal:
ForMinimal mode:
claude mcp add postman -- npx @postman/mcp-server@latest
ForFull mode:
claude mcp add postman -- npx @postman/mcp-server@latest --full
To install the MCP server as a Gemini CLI extension, run the following command in your terminal:
gemini extensions install https://github.com/postmanlabs/postman-mcp-server
For Docker set up and installation, seeDOCKER.md.
If you're migrating from Postman MCP Server version 1.x to 2.x, be aware of the following:
- Tool naming changes - All tool names changed from kebab-case to camelCase. For example:
create-collection
→createCollection
get-workspaces
→getWorkspaces
delete-environment
→deleteEnvironment
- Tool availability changes
- The default (minimal) behavior provides only 37 essential tools.
- The
--full
flag provides access to all tools.
- See thePostman Agent Generator page for updates and new capabilities.
- SeeAdd your MCP requests to your collections to learn how to use Postman to perform MCP requests.
- Visit thePostman 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 thePostman MCP Server collection.
About
Postman
Bypostmanlabs·56
Postman's MCP server connects AI agents, assistants, and chatbots directly to your APIs on Postman. Use natural language to prompt AI to automate work across your Postman collections, environments, workspaces, and more.