Postman MCP Server — Claude Code MCP server: setup
Connect Claude Code to Postman to work with collections, workspaces, and API definitions from your editor. Choose a tool mode based on what you need the agent to access.
claude mcp add postman-mcp-server -e POSTMAN_API_KEY=<POSTMAN_API_KEY> -- npx -y @postman/postman-mcp-serverWhat Postman MCP Server does
The server connects an AI agent to Postman through MCP. Minimal provides core operations for Postman elements; Code adds tools for API context and generating client code from API definitions. Learn searches Postman documentation, while Full exposes all available Postman API tools.
Claude Code can connect to the remote server over HTTP or run the local server with npx. The main remote server supports OAuth without manual API key setup. Local use requires POSTMAN_API_KEY; the EU server also requires a Postman API key because it does not support OAuth.
The remote server cannot reach services on your workstation’s network, so it cannot test local APIs. Use the local server for that task.
What it helps with
- test an API with a Postman collection
- give an agent context from an API definition
- generate client code from an API definition
- edit Postman collections from an editor
Example prompts for the agent
- Test this API with my Postman collection and report the results.
- Find the API definition in Postman and use it as context for this code.
- Generate client code from the API definition in Postman.
How to install Postman MCP Server
1Platform CLI
claude mcp add postman-mcp-server -e POSTMAN_API_KEY=<POSTMAN_API_KEY> -- npx -y @postman/postman-mcp-serverReplace <…> with your own values
2Platform CLI: remote server
claude mcp add --transport http postman-mcp-server https://mcp.postman.com/mcp1Platform CLI: remote server
codex mcp add postman-mcp-server --url https://mcp.postman.com/mcp2Platform CLI
codex mcp add postman-mcp-server --env POSTMAN_API_KEY=<POSTMAN_API_KEY> -- npx -y @postman/postman-mcp-serverReplace <…> with your own values
Config file
{
"mcpServers": {
"postman-mcp-server": {
"url": "https://mcp.postman.com/mcp"
}
}
}{
"mcpServers": {
"postman-mcp-server": {
"command": "npx",
"args": [
"-y",
"@postman/postman-mcp-server"
],
"env": {
"POSTMAN_API_KEY": "<POSTMAN_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"postman-mcp-server": {
"type": "http",
"url": "https://mcp.postman.com/mcp"
}
}
}{
"servers": {
"postman-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@postman/postman-mcp-server"
],
"env": {
"POSTMAN_API_KEY": "<POSTMAN_API_KEY>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http postman-mcp-server https://mcp.postman.com/mcp2Platform CLI
gemini mcp add -e POSTMAN_API_KEY=<POSTMAN_API_KEY> postman-mcp-server npx -y @postman/postman-mcp-serverReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Postman MCP Server
How do I install Postman MCP Server in Claude Code?
For a remote connection, run claude mcp add --transport http postman-mcp-server https://mcp.postman.com/mcp.
What does Postman MCP Server do?
It connects an agent to Postman so it can work with collections, workspaces, and APIs. Available tools depend on the selected mode.
Does Postman MCP Server require an API key?
The main remote server supports OAuth without manual API key setup. Local use and the EU server require a Postman API key.
