Postman

v2.8.9APIsstable

Postman’s remote 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.

aimcpmcp-serverpostmananthropic
Share:
244
Stars
0
Downloads
0
Weekly
0/5

What is Postman?

Postman is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to postman’s remote 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, environme...

Postman’s remote 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.

This server falls under the APIs category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Postman’s remote MCP server connects AI agents, assistants,

Use Cases

Automate API workflows with AI
Execute Postman collections
Test APIs with natural language
postmanlabs

Maintainer

LicenseApache 2.0
Languagetypescript
Versionv2.8.9
UpdatedMay 21, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

NPM

npx -y @postman/postman-mcp-server

Manual Installation

npx -y @postman/postman-mcp-server

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Postman

The Postman MCP server connects AI agents and chat assistants directly to your Postman workspaces, collections, environments, and API definitions so you can automate API workflows using plain language. It ships in three modes — Minimal, Code, and Full — providing anywhere from a handful of essential collection-management tools to more than 100 tools covering every Postman API operation. Security teams, backend developers, and QA engineers use it to run collections, generate client code, manage environments, and document APIs without leaving their AI interface.

Prerequisites

  • Node.js 18 or later installed (for local mode)
  • A Postman account with at least one workspace
  • A Postman API key from https://web.postman.co/settings/me/api-keys (required for local mode and EU remote mode)
  • An MCP-compatible client such as Claude Desktop, Cursor, or VS Code
1

Generate a Postman API key

Log in to Postman, go to Settings > API Keys, and generate a new key. Copy it immediately as it will not be shown again. This key authenticates all requests the MCP server makes on your behalf.

2

Choose remote or local server mode

For the simplest setup, use the remote Postman MCP server at https://mcp.postman.com which supports OAuth. For local mode with an API key, use npx to run the server process.

# Local mode with API key
npx @postman/postman-mcp-server

# Local mode — Full set of tools
npx @postman/postman-mcp-server --full

# EU region
npx @postman/postman-mcp-server --region eu
3

Configure Claude Desktop for local mode

Add the server entry to your Claude Desktop configuration file, providing your Postman API key as an environment variable.

{
  "mcpServers": {
    "postman": {
      "command": "npx",
      "args": ["-y", "@postman/postman-mcp-server"],
      "env": {
        "POSTMAN_API_KEY": "your-postman-api-key"
      }
    }
  }
}
4

Alternatively, connect to the remote server

For remote OAuth-based access (no API key in config), point your MCP client at the hosted endpoint.

{
  "mcpServers": {
    "postman-remote": {
      "command": "npx",
      "args": ["mcp-remote", "https://mcp.postman.com/mcp"]
    }
  }
}
5

Restart your MCP client and verify

Restart Claude Desktop or your chosen client. Open a new conversation and ask it to list your Postman workspaces to confirm the connection is working.

Postman Examples

Client configuration

Claude Desktop configuration for the Postman MCP server in local mode with an API key.

{
  "mcpServers": {
    "postman": {
      "command": "npx",
      "args": ["-y", "@postman/postman-mcp-server"],
      "env": {
        "POSTMAN_API_KEY": "PMAK-your-postman-api-key"
      }
    }
  }
}

Prompts to try

Example prompts that use Postman MCP tools to manage collections, environments, and API definitions.

- "List all my Postman workspaces and their collections"
- "Run the 'User Auth' collection in my staging environment and show me the results"
- "Generate TypeScript client code from my Payments API OpenAPI spec"
- "Create a new environment called 'production' with BASE_URL set to https://api.myapp.com"
- "Add a POST /users request to the 'Core API' collection with a JSON body schema"

Troubleshooting Postman

Authentication errors or '401 Unauthorized' responses

Verify your POSTMAN_API_KEY is correct and has not expired. Keys are prefixed with 'PMAK-'. Regenerate the key in Postman Settings > API Keys if needed, and update your MCP config.

Tools not appearing or only a small subset visible

By default the server runs in Minimal mode with a limited tool set. Add the '--full' argument to your args array to enable all 100+ Postman API tools, or '--code' for code generation tools.

EU workspace data not accessible

Postman EU customers must use '--region eu' in the args and authenticate with a valid POSTMAN_API_KEY. The default remote endpoint points to the US region.

Frequently Asked Questions about Postman

What is Postman?

Postman is a Model Context Protocol (MCP) server that postman’s remote 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. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Postman?

Install via npm with the command: npx -y @postman/postman-mcp-server. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).

Which AI clients work with Postman?

Postman works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Postman free to use?

Yes, Postman is open source and available under the Apache 2.0 license. You can use it freely in both personal and commercial projects.

Browse More APIs MCP Servers

Explore all apis servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "postman": { "command": "npx", "args": ["-y", "@postman/postman-mcp-server"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Postman?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides