# Postman MCP Server

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 325
- Author: postmanlabs
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/postmanlabs/postman-mcp-server
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/postman-mcp-server

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.postman.com/mcp`
- Environment variables: `POSTMAN_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.
- Works with: Postman

## Install

### Claude Code (native platform)

1. **Platform CLI**
```bash
claude mcp add postman-mcp-server -e POSTMAN_API_KEY=<POSTMAN_API_KEY> -- npx -y @postman/postman-mcp-server
```
Replace <…> with your own values

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http postman-mcp-server https://mcp.postman.com/mcp
```

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add postman-mcp-server --url https://mcp.postman.com/mcp
```

2. **Platform CLI**
```bash
codex mcp add postman-mcp-server --env POSTMAN_API_KEY=<POSTMAN_API_KEY> -- npx -y @postman/postman-mcp-server
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "postman-mcp-server": {
            "url": "https://mcp.postman.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "postman-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@postman/postman-mcp-server"
            ],
            "env": {
                "POSTMAN_API_KEY": "<POSTMAN_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "postman-mcp-server": {
            "type": "http",
            "url": "https://mcp.postman.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "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

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http postman-mcp-server https://mcp.postman.com/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e POSTMAN_API_KEY=<POSTMAN_API_KEY> postman-mcp-server npx -y @postman/postman-mcp-server
```
Replace <…> with your own values

## When to use it
- 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
- 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.

## Similar
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16717
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40409
- [OpenWork MCP Gateway](https://affpapa.org/en/nevibecode/mcp/openwork-mcp-gateway.md) — MCP server · ★ 24242
- [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18727
- [Nhost](https://affpapa.org/en/nevibecode/mcp/nhost.md) — MCP server · ★ 9366
- [basebalance.cloud — x402 RPC & MCP gateway](https://affpapa.org/en/nevibecode/mcp/basebalancecloud-x402-rpc-mcp-gateway.md) — MCP server · ★ 7506

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md