# postman-mcp-server [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/postmanlabs/postman-mcp-server  
**GitHub Stars:** 326  
**npm Downloads (last month):** 43361  
**Views:** 9  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/postman-mcp-server

## Description
A basic MCP server to operate on the Postman API.

## Tools
Capabilities this server exposes over MCP:

- **Minimal** — (Default) Only includes essential tools for basic Postman operations. Ideal for users who want to modify a single Postman element, such as collections, workspaces, or environments.
- **Code** — Includes tools to generate high-quality, well-organized client code from public and internal API definitions. Ideal for users who need to consume APIs or get API context to their agents.
- **Full** — Includes all available Postman API tools (100+ tools). Ideal for users who engage in advanced collaboration and Postman's Enterprise features.
- **Learn** — Searches [Postman Docs](https://learning.postman.com/) for guides, tutorials, and reference content. Ideal for agents who need to discover Postman features, look up API concepts, or find learning resources.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "postman-mcp-server": {
    "command": "npx",
    "args": ["-y","@postman/postman-mcp-server"],
    "env": {
      "POSTMAN_API_KEY": "",
      "POSTMAN_API_BASE_URL": ""
    }
  }
}
```

**Requires environment variables:** `POSTMAN_API_KEY`, `POSTMAN_API_BASE_URL` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What postman-mcp-server does

postman-mcp-server exposes Postman operations through the Model Context Protocol. Agents and coding assistants can work with Postman workspaces, collections, specifications, and environments without switching away from their host application.

The server supports four tool configurations. Minimal is the default and focuses on essential operations for individual Postman resources. Code adds client-code generation from public and internal API definitions. Full exposes more than 100 Postman API tools for broader collaboration and Enterprise workflows. Learn searches Postman Docs for guides, tutorials, reference material, and API concepts.

Typical uses include maintaining collections and environments, synchronizing API definitions with application code, creating specifications from code, generating collections from specifications, and producing client code for APIs.

## How it works

You can connect to Postman’s remote MCP service over streamable HTTP or launch the package locally over STDIO. The remote service uses OAuth at `https://mcp.postman.com`; its path selects the tool configuration, with `/minimal` for the default set, `/code` for code generation, and `/mcp` for Full mode. Remote access is suitable when the agent only needs the hosted Postman connection.

Run the local package with `npx @postman/postman-mcp-server`. Add `--code` or `--full` to select those configurations. Local execution is the relevant option for testing APIs on a developer’s workstation because the remote server cannot reach that workstation’s network.

## Setup and configuration

For a local installation, provide a Postman API key through `POSTMAN_API_KEY`. The EU region can be selected with `--region eu`, or configured through `POSTMAN_API_BASE_URL`. The EU remote endpoints are available at `https://mcp.eu.postman.com/mcp` for Full mode, `/code`, and `/minimal`.

OAuth is available on the primary remote service and does not require manually configuring an API key. The EU remote and local deployments use API key authentication instead. Postman publishes the server as the `@postman/postman-mcp-server` npm package and provides setup guidance for supported agents and IDEs.

## Tools and capabilities

- Manage Postman collections, including creating, updating, tagging, documenting, commenting, and handling multiple collections.
- Create and manage workspaces and environments, including environment variables.
- Generate client code from public or internal API definitions.
- Create specifications from application code and generate collections from specifications.
- Search Postman Docs for feature guidance, tutorials, reference content, and API concepts.
- Access the broader Postman API tool set through Full mode, which contains more than 100 tools.

## Limitations and notes

The remote service cannot access APIs running on the local workstation, so local execution is needed for those testing scenarios. OAuth is not supported by the EU remote server. Tool availability depends on the selected configuration: Minimal is intentionally narrower, while Code, Full, and Learn add different capabilities rather than exposing one identical tool set.

A Postman MCP Server collection can be used to browse available tools and test the remote or local connection. Docker setup is also available for the local deployment.

_Full upstream README: https://allmcps.com/mcp/postman-mcp-server/readme_