---
title: "Postman MCP Server: Collections, Specs and API Client Code"
url: "https://mcpshelf.co/servers/postman"
description: "Postman's own MCP server connects Claude Code, Cursor and VS Code to your collections, specs, environments and mocks. Minimal, Code and Full modes."
updated: "2026-11-10"
site: "MCP Shelf"
---

# Postman MCP Server

> Your Postman workspaces, collections, specs and mocks, from inside the editor.

Source: https://mcpshelf.co/servers/postman  
Markdown: https://mcpshelf.co/servers/postman.md  
Generated: 2026-11-22T13:57:56.898Z

## Facts

- **Name:** Postman MCP Server
- **Tagline:** Your Postman workspaces, collections, specs and mocks, from inside the editor.
- **Description:** Postman MCP Server is Postman's official server that lets a coding agent work with your Postman workspaces, collections, specs, environments and mocks, and write client code from them.
- **Repository:** https://github.com/postmanlabs/postman-mcp-server
- **Install:** `claude mcp add --transport http postman https://mcp.postman.com/minimal`
- **Server URL:** https://mcp.postman.com/minimal
- **Transport:** Streamable HTTP (remote)
- **Auth:** No required keys or settings listed
- **Tools exposed:** 42: `createCollection`, `createEnvironment`, `createMock`, `createSpec`, `createSpecFile`, `createWorkspace`, `generateCollection`, `generateSpecFromCollection`, `getAllSpecs`, `getAuthenticatedUser`, `getCollection`, `getCollections`, `getEnvironment`, `getEnvironments`, `getGeneratedCollectionSpecs`, `getMock`, `getMocks`, `getSpec`, `getSpecCollections`, `getSpecDefinition`, `getSpecFile`, `getSpecFiles`, `getTaggedEntities`, `getWorkspace`, `getWorkspaces`, `publishMock`, `putCollection`, `putEnvironment`, `syncCollectionWithSpec`, `syncSpecWithCollection`, `updateMock`, `updateSpecFile`, `updateSpecProperties`, `updateWorkspace`, `createCollectionRequest`, `createCollectionResponse`, `duplicateCollection`, `getDuplicateCollectionTaskStatus`, `runCollection`, `getEnabledTools`, `updateCollectionRequest`, `searchPostmanElements`
- **Category:** Developer tools (https://mcpshelf.co/categories/developer-tools)
- **Stats:** 325 GitHub stars, 9.4K downloads a week, last commit 23 Oct 2026, 0 upvotes on MCP Shelf
- **Install check:** Needs your setup first
- **Listed:** 2026-11-10
- **Page updated:** 2026-11-10

## Full description

### What is Postman MCP Server?

**Postman MCP Server is Postman's official server that lets a coding agent work with your Postman workspaces, collections, specs, environments and mocks, and write client code from them.**

Postman maintains this server, which connects a coding agent to your Postman account. It can read and create collections, requests and environments, keep a collection and an OpenAPI spec in sync in either direction, generate a collection from a spec, run a collection, and publish a mock server. A separate Code mode pulls a request's full context so the agent can write client code against an API you have in Postman.

You choose how much to load. Minimal, the default, has about 40 tools for everyday edits; Full exposes the whole Postman API with over 200; Code is for generating client code; Learn only searches the Postman docs. The hosted server signs in with OAuth, and a local npx package takes an API key.

|  |  |
| --- | --- |
| Made by | Postman (postmanlabs/postman-mcp-server) |
| GitHub | https://github.com/postmanlabs/postman-mcp-server |
| Licence | Apache-2.0 |
| GitHub stars | 325 |
| Downloads | 9.4K a week |
| Last commit | 23 Oct 2026 |
| Tools | 42 |
| Runs on | Hosted |
| Install check | Needs your setup first |
| Category | [Developer tools](https://mcpshelf.co/categories/developer-tools) |
| Works with | Claude Code, Cursor, Claude Desktop, VS Code, Codex, Windsurf, ChatGPT |
| Setup checked | 10 Nov 2026 |
| Page updated | 10 Nov 2026 |

**Our check:** It needs something our Linux test machine does not have (an account, a desktop app, a Mac or a running service), so on 10 Nov 2026 we read its tools from the source code instead of running this config. The shared database pointed at the Full URL with an API key header. Postman recommends OAuth on the Minimal endpoint as the place to start, so this page uses that.

#### Try asking Postman MCP Server

- "List the collections in my workspace."
- "Create a collection for our users API with requests for each endpoint."
- "Set up a mock server for the orders collection."

#### MCP Shelf take

> Postman needs something our Linux test machine does not have (an account, an app or a service), so on 10 Nov 2026 we read its source and counted 42 tools. 20 of the 42 only read; the other 22 can change things. It sits 24th of 24 in its category on our shelf by GitHub stars (325, with 9.4K downloads a week).

— MCP Shelf tests (numbers from our own runs), tested on 10 Nov 2026

### What tools does Postman MCP Server have?

We listed 42 tools on 10 Nov 2026. 20 only read; the rest can change things or run commands.

| Tool | Kind | What it is for |
| --- | --- | --- |
| `createCollection` | changes | Creates a collection in a workspace. |
| `createEnvironment` | changes | Creates an environment with variables. |
| `createMock` | changes | Creates a mock server from a collection. |
| `createSpec` | changes | Creates a spec from an OpenAPI or AsyncAPI definition. |
| `createSpecFile` | changes | Adds a file to a spec. |
| `createWorkspace` | changes | Creates a workspace. |
| `generateCollection` | changes | Generates a collection from a spec. |
| `generateSpecFromCollection` | changes | Generates an OpenAPI spec from a collection. |
| `getAllSpecs` | reads | Lists the API specs in a workspace. |
| `getAuthenticatedUser` | reads | Shows which Postman user and team the session is signed in as. |
| `getCollection` | reads | Reads a whole collection, with its folders, requests and scripts. |
| `getCollections` | reads | Lists the collections in a workspace. |
| `getEnvironment` | reads | Reads an environment and its variables. |
| `getEnvironments` | reads | Lists the environments in a workspace. |
| `getGeneratedCollectionSpecs` | reads | Shows which spec a generated collection came from. |
| `getMock` | reads | Reads one mock server. |
| `getMocks` | reads | Lists mock servers. |
| `getSpec` | reads | Reads a spec's details. |
| `getSpecCollections` | reads | Lists the collections generated from a spec. |
| `getSpecDefinition` | reads | Returns a spec's full OpenAPI or AsyncAPI definition. |
| `getSpecFile` | reads | Reads one spec file. |
| `getSpecFiles` | reads | Lists the files that make up a multi-file spec. |
| `getTaggedEntities` | reads | Finds the collections, workspaces and APIs that carry a tag. |
| `getWorkspace` | reads | Reads one workspace, with the collections, environments, specs and mocks in it. |
| `getWorkspaces` | reads | Lists the workspaces you can see. |
| `publishMock` | changes | Makes a mock server public so anyone with the URL can call it. |
| `putCollection` | changes | Replaces a collection with a new version. |
| `putEnvironment` | changes | Replaces an environment's variables. |
| `syncCollectionWithSpec` | changes | Updates a generated collection to match its spec after the spec changes. |
| `syncSpecWithCollection` | changes | Updates a spec to match changes made in its collection. |
| `updateMock` | changes | Changes a mock server's settings. |
| `updateSpecFile` | changes | Changes the content of a spec file. |
| `updateSpecProperties` | changes | Renames a spec or changes its description. |
| `updateWorkspace` | changes | Renames a workspace or changes its description. |
| `createCollectionRequest` | changes | Adds a request to a collection or folder. |
| `createCollectionResponse` | changes | Saves an example response on a request. |
| `duplicateCollection` | changes | Copies a collection into another workspace, as a background task. |
| `getDuplicateCollectionTaskStatus` | reads | Checks whether a collection copy has finished. |
| `runCollection` | changes | Runs a collection's requests and tests and returns the results. |
| `getEnabledTools` | reads | Lists which tools the Minimal and Full sets include, so the agent can find another way when a tool is missing. |
| `updateCollectionRequest` | changes | Changes a request's method, URL, headers, body or scripts. |
| `searchPostmanElements` | reads | Searches Postman for workspaces, collections and requests by name. |

#### Tool groups

| Group | Covers |
| --- | --- |
| `Minimal (default, /minimal)` | About 40 tools: workspaces, collections, requests and example responses, environments, specs and spec files, generating and syncing collections and specs, mocks, tags, search and collection runs. |
| `Code (/code or --code)` | About 20 tools that gather a request's or an API's full context, such as its definition, auth, variables and examples, so the agent can generate client code in your project's style. |
| `Full (/mcp or --full)` | The whole Postman API, over 200 tools, including comments, forks, pull requests, monitors, API governance and Enterprise features. |
| `Learn` | searchLearningCenter alone, which searches Postman's docs, guides and tutorials. |

### How do I install Postman MCP Server?

#### Install steps from the Postman MCP Server README

Copied from the project's [README on GitHub](https://github.com/postmanlabs/postman-mcp-server#readme) on 10 Nov 2026 under its Apache-2.0 licence.

##### 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](https://modelcontextprotocol.io/specification/draft/basic/authorization) and requires no manual API key configuration.

The EU remote server and the local server support only [Postman API key](https://postman.postman.co/settings/me/api-keys) 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](https://learning.postman.com/docs/reference/postman-api/postman-mcp-server/overview).

---

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

---

#### What you need first

- A Postman account (OAuth on the US hosted server) or a Postman API key
- Node.js 20 or newer for the local package

#### Claude Code

Where: Your terminal, in the project folder

```bash
claude mcp add --transport http postman https://mcp.postman.com/minimal
```

claude mcp add --transport http postman https://mcp.postman.com/minimal, then /mcp to sign in to Postman. Use /code or /mcp at the end of the URL for the other modes.

#### Cursor

Where: ~/.cursor/mcp.json, or .cursor/mcp.json in a project

```json
{
  "mcpServers": {
    "postman": {
      "url": "https://mcp.postman.com/minimal"
    }
  }
}
```

#### Claude Desktop

Where: Customize → Connectors → add a custom connector

```
https://mcp.postman.com/minimal
```

Add the URL as a custom connector and sign in to Postman when asked. For the local package, use npx @postman/postman-mcp-server with POSTMAN_API_KEY in env.

#### VS Code

Where: .vscode/mcp.json in your project

```json
{
  "servers": {
    "postman": {
      "type": "http",
      "url": "https://mcp.postman.com/minimal"
    }
  }
}
```

#### Codex

Where: ~/.codex/config.toml, shared by the Codex CLI, IDE extension and ChatGPT desktop app

```
[mcp_servers.postman]
url = "https://mcp.postman.com/minimal"
```

Or run: `codex mcp add postman --url https://mcp.postman.com/minimal`, then `codex mcp login postman` if it asks you to sign in.

#### Windsurf

Where: ~/.codeium/windsurf/mcp_config.json

```json
{
  "mcpServers": {
    "postman": {
      "serverUrl": "https://mcp.postman.com/minimal"
    }
  }
}
```

#### ChatGPT

Where: chatgpt.com/plugins → + → Add custom MCP server

```
https://mcp.postman.com/minimal
```

Paste the URL as the server address, choose OAuth if it asks you to sign in, create it as a plugin, then install it before using it in a chat. Workspace admins can block custom servers.

Swap /minimal for /code or /mcp to get Code or Full mode. The EU server, https://mcp.eu.postman.com/minimal, needs an Authorization: Bearer header with your API key instead of OAuth.

Checked against the project's own install docs on 10 Nov 2026: https://github.com/postmanlabs/postman-mcp-server#readme, https://learning.postman.com/docs/reference/postman-api/postman-mcp-server/overview, https://www.npmjs.com/package/@postman/postman-mcp-server

### How do I configure Postman MCP Server?

| Setting | Kind | Required | What it does |
| --- | --- | --- | --- |
| `https://mcp.postman.com/minimal` | config | no | The US hosted server in Minimal mode. It signs in with OAuth, so no key is needed. Use /code or /mcp at the end for Code or Full. |
| `Authorization: Bearer` | config | no | Header carrying a Postman API key, for the EU server or a client that cannot do OAuth. Example: `Authorization: Bearer PMAK-your-key` |
| `https://mcp.eu.postman.com/minimal` | config | no | The EU hosted server, also at /code and /mcp. It accepts only an API key, not OAuth. |
| `POSTMAN_API_KEY` | env | no | Your Postman API key for the local npx @postman/postman-mcp-server package. |
| `--code, --full and --region eu` | flag | no | Flags for the local package: pick Code or Full mode instead of Minimal, and point it at Postman's EU region (or set POSTMAN_API_BASE_URL). Example: `npx @postman/postman-mcp-server --full --region eu` |

### What can Postman MCP Server read and change?

**It can read**

- Your workspaces, collections, requests, environments and their variables
- API specs, mock servers, tags and your Postman user details
- Postman's documentation, in Learn mode

**It can change**

- Collections, requests, environments, specs and workspaces, including replacing them
- Mock servers, including making one public
- Runs collections, which send real requests to the APIs they call

**Safer setup:** Start with Minimal, and use a Postman API key from an account or team that only has the workspaces you want touched. Ask the agent to show you a change before it calls putCollection or putEnvironment, which replace the whole thing.

### Good for

- Keeping a Postman collection in step with the API code you are changing
- Turning an OpenAPI spec into a collection, or a collection into a spec
- Generating a typed API client from requests your team already keeps in Postman

### Postman MCP Server not working? Common fixes

**OAuth fails on the EU server**
The EU server has no OAuth. Send your Postman API key in an Authorization: Bearer header, or use the US server if your team is not on the EU data region.

**A collection run cannot reach my local API**
The hosted server runs in Postman's cloud and cannot see localhost. Use the local npx package to test APIs on your own machine.

**The tool I need is missing**
Minimal leaves most of the Postman API out. Switch the URL to /mcp, or add --full to the local package, for every tool, or ask the agent to call getEnabledTools to see where it lives.

**The model is slow or picks the wrong tool in Full mode**
Full loads over 200 tools. Go back to Minimal, or Code if you are generating client code, unless you need the Enterprise features.

**The local server will not start**
It needs Node.js 20 or newer and POSTMAN_API_KEY in its env. Create a key under your Postman account settings, API keys.

### What are the alternatives to Postman MCP Server?

| Server | What it does | Tools | Runs on | Licence | Stars |
| --- | --- | --- | --- | --- | --- |
| [Postman MCP Server](https://mcpshelf.co/servers/postman) | Your Postman workspaces, collections, specs and mocks, from inside the editor. | 42 | Hosted | Apache-2.0 | 325 |
| [Desktop Commander](https://mcpshelf.co/servers/desktop-commander) | A terminal, file search and surgical file edits for your assistant. | 25 | Your computer | MIT | 10.2K |
| [Serena](https://mcpshelf.co/servers/serena) | IDE-style "find symbol" and "edit symbol" for an agent, backed by language servers. | 3 (REPL) | Your computer | GPL-3.0 | 30.8K |
| [Context7](https://mcpshelf.co/servers/context7) | Pulls current, version-specific library docs into the conversation. | 2 | Your computer or hosted | MIT | 63.8K |
| [GitHub](https://mcpshelf.co/servers/github) | GitHub's own server for repos, issues, pull requests and Actions. | 46 | Hosted or your computer | MIT | 34K |
| [MCP Inspector](https://mcpshelf.co/servers/mcp-inspector) | The official debugging UI for MCP servers. Not a server you add to a client. | Test client | Your computer | MIT / Apache-2.0 | 11.2K |

### Postman MCP Server FAQ

#### Is the Postman MCP Server official?

Yes. Postman builds it in the postmanlabs organisation on GitHub, runs the hosted server at mcp.postman.com and publishes the local version as @postman/postman-mcp-server on npm, under Apache-2.0.

#### Which mode should I pick: Minimal, Code or Full?

Minimal, the default, covers everyday work on collections, environments, specs and mocks. Code is for generating client code from APIs in Postman. Full adds the rest of the Postman API, over 200 tools.

#### Do I need a Postman API key?

Not on the US hosted server, which signs in with OAuth. The EU server and the local npx package only take an API key, sent as a Bearer header or set as POSTMAN_API_KEY.

#### How do I add the Postman MCP Server to Cursor or VS Code?

Add https://mcp.postman.com/minimal as a remote server and sign in when the editor opens Postman's login. Postman's docs have a page for each editor, including Codex, Kiro and GitHub Copilot CLI.

#### Can it keep my OpenAPI spec and collection in sync?

Yes. generateCollection builds a collection from a spec, and syncCollectionWithSpec and syncSpecWithCollection update one after the other has changed, in either direction.

#### Can the agent run my API tests?

Yes, runCollection runs a collection and its test scripts. The hosted server cannot reach localhost, so use the local package for APIs that only run on your machine.

#### Does it work in Postman's EU region?

Yes. Use mcp.eu.postman.com with an API key, or pass --region eu to the local package. OAuth is only available on the US server.

#### What does it cost?

The server is free to use with any Postman account. What you can reach depends on your Postman plan, so Enterprise features in Full mode need an Enterprise team.

#### Does Postman MCP Server work with Codex?

Yes. Run codex mcp add postman --url https://mcp.postman.com/minimal in a terminal, or add an [mcp_servers.postman] table to ~/.codex/config.toml, which the Codex CLI and IDE extension share. Then codex mcp login postman if it asks you to sign in.

Full docs on GitHub: https://github.com/postmanlabs/postman-mcp-server

## Notes for agents

Fetch these instead of parsing the HTML page:

- llms.txt: https://mcpshelf.co/llms.txt
- llms-full.txt: https://mcpshelf.co/llms-full.txt
- ai.txt: https://mcpshelf.co/ai.txt
- Full catalog (.md): https://mcpshelf.co/catalog.md
- API spec: https://mcpshelf.co/openapi.json
- MCP server: https://mcpshelf.co/mcp
- MCP manifest: https://mcpshelf.co/.well-known/mcp.json
- Developer docs: https://mcpshelf.co/developers

MCP endpoint (Streamable HTTP, no key): https://mcpshelf.co/mcp. REST API: https://mcpshelf.co/api/v1.

