Skip to content
Back to search

postman-mcp-server

Postman MCP Server — connect AI agents (Claude Code, Cursor, VS Code Copilot, Gemini CLI) to your Postman collections, OpenAPI specs, and environments via Model Context Protocol (MCP)

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/postmanlabs/postman-mcp-server with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/postmanlabs/postman-mcp-server'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/postmanlabs--postman-mcp-server/badge.svg)](/listings/postmanlabs--postman-mcp-server)

HTML

<a href="/listings/postmanlabs--postman-mcp-server"><img src="/api/listings/postmanlabs--postman-mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

**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).

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 138 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # Postman MCP Server
  2. The **Postman MCP Server** implements the [Model Context Protocol (MCP)](https://modelcontextprotocol.io) to connect AI agents and coding assistants — including Claude Code, Cursor, VS Code Copilot, GitHub Copilot CLI, and Gemini CLI — directly to your Postman workspaces, collections, specifications, and environments.
  3. Postman also offers the server as an [npm package](https://www.npmjs.com/package/@postman/postman-mcp-server).
  4. For the full installation guide with agent-specific setup, see Postman's [MCP Server product page](https://www.postman.com/product/mcp-server/).
  5. ---
  6. ## Postman MCP Server collection
  7. The [Postman MCP Server collection](https://www.postman.com/postman/postman-public-workspace/collection/681dc649440b35935978b8b7) is the quickest way to explore, test, and connect to the Postman MCP Server. Use it to:
  8. - Browse the complete list of available tools across all configurations.
  9. - Connect to and test the remote server — [Full](https://www.postman.com/postman/postman-public-workspace/mcp-request/6821a76b17ccb90a86df48d3) and [Minimal](https://www.postman.com/postman/postman-public-workspace/mcp-request/689e1c635be722a98b723238).
  10. - Connect to and test the [local server](https://www.postman.com/postman/postman-public-workspace/mcp-request/6866a655b36c67cc435b5033).
  11. ---
  12. ## Tool configurations
  13. - **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.
  14. - **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.
  15. - **Full** — Includes all available Postman API tools (100+ tools). Ideal for users who engage in advanced collaboration and Postman's Enterprise features.
  16. - **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.
  17. ---
  18. ## Authentication
  19. 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.
  20. The EU remote server and the local server support only [Postman API key](https://postman.postman.co/settings/me/api-keys) authentication.
  21. ---
  22. ## Quick start
  23. **Remote** (any OAuth-compatible MCP host):
  24. Add this URL to your MCP host's configuration:
  25. ```bash
  26. https://mcp.postman.com/minimal
  27. ```
  28. 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.
  29. **Local:**
  30. ```bash
  31. npx @postman/postman-mcp-server
  32. ```
  33. Add `--code` or `--full` for Code or Full mode. Set `POSTMAN_API_KEY` as an environment variable.
  34. 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).
  35. ---
  36. ## Supported agents and IDEs
  37. | Agent / IDE | Remote | Local |
  38. | --- | --- | --- |
  39. | Claude Code | [Docs](https://learning.postman.com/docs/reference/postman-api/postman-mcp-server/postman-mcp-remote-server#claude-code) | [Docs](https://learning.postman.com/docs/reference/postman-api/postman-mcp-server/postman-mcp-local-server#claude-code) |
  40. | Claude Desktop | [Docs](https://learning.postman.com/docs/reference/postman-api/postman-mcp-server/postman-mcp-remote-server#claude) | [Docs](https://learning.postman.com/docs/reference/postman-api/postman-mcp-server/postman-mcp-local-server#claude) |
  41. | Cursor | [Docs](https://learning.postman.com/docs/reference/postman-api/postman-mcp-server/postman-mcp-remote-server#cursor) | [Docs](https://learning.postman.com/docs/reference/postman-api/postman-mcp-server/postman-mcp-local-server#cursor) |
  42. | VS Code | [Docs](https://learning.postman.com/docs/reference/postman-api/postman-mcp-server/postman-mcp-remote-server#visual-studio-code) | [Docs](https://learning.postman.com/docs/reference/postman-api/postman-mcp-server/postman-mcp-local-server#visual-studio-code) |
  43. | Codex | [Docs](https://learning.postman.com/docs/reference/postman-api/postman-mcp-server/postman-mcp-remote-server#codex) | [Docs](https://learning.postman.com/docs/reference/postman-api/postman-mcp-server/postman-mcp-local-server#codex) |
  44. | Antigravity CLI | [Docs](https://learning.postman.com/docs/reference/postman-api/postman-mcp-server/postman-mcp-remote-server#antigravity-cli) | [Docs](https://learning.postman.com/docs/reference/postman-api/postman-mcp-server/postman-mcp-local-server#antigravity-cli) |
  45. | GitHub Copilot CLI | [Docs](https://learning.postman.com/docs/reference/postman-api/postman-mcp-server/postman-mcp-remote-server#github-copilot-cli) | [Docs](https://learning.postman.com/docs/reference/postman-api/postman-mcp-server/postman-mcp-local-server#github-copilot-cli) |
  46. | Kiro | [Docs](https://learning.postman.com/docs/reference/postman-api/postman-mcp-server/postman-mcp-remote-server#kiro) | [Docs](https://learning.postman.com/docs/reference/postman-api/postman-mcp-server/postman-mcp-local-server#kiro) |
  47. | Docker | — | [Docs](https://learning.postman.com/docs/reference/postman-api/postman-mcp-server/postman-mcp-local-server#docker) |
  48. ---
  49. ## EU support
  50. The Postman MCP Server supports the EU region for remote and local servers:
  51. - 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`.
  52. - For the STDIO public package, use the `--region eu` flag, or set the `POSTMAN_API_BASE_URL` environment variable directly.
  53. - OAuth isn't supported for the EU server. The EU remote server only supports API key authentication.
  54. ---
  55. ## Use cases
  56. - **API Testing** — Continuously test your API using your Postman collection. Use the local server to test local APIs, as the remote server won't have network access to your workstation.
  57. - **Code synchronization** — Keep your code in sync with your [Postman Collections](https://learning.postman.com/docs/design-apis/collections/overview/) and specs.
  58. - **Collection management** — Create and tag collections, update documentation, add comments, or perform actions across multiple collections without leaving your editor.
  59. - **Workspace and environment management** — Create workspaces and environments, plus manage environment variables.
  60. - **Automatic spec creation** — Create specs from your code and use them to generate collections.
  61. - **Client code generation** — Generate production-ready client code that consumes APIs following best practices and project conventions.
  62. ---
  63. ## Docker
  64. For Docker setup and installation, see [DOCKER.md](https://github.com/postmanlabs/postman-mcp-server/blob/main/DOCKER.md).
  65. ---
  66. ## Contributing
  67. Bug reports, tool requests, and documentation fixes are all welcome — see
  68. [CONTRIBUTING.md](./CONTRIBUTING.md).
  69. - [Report a bug](https://github.com/postmanlabs/postman-mcp-server/issues/new?template=bug_report.yml)
  70. - [Request a tool, or a change to one](https://github.com/postmanlabs/postman-mcp-server/issues/new?template=tool_request.yml)
  71. - [Report a documentation issue](https://github.com/postmanlabs/postman-mcp-server/issues/new?template=docs_issue.yml)
  72. The MCP tool definitions and the server implementation here are synced from Postman's
  73. internal source of truth, so changes to files under `src/` can't be merged in this
  74. repository — but issues are how those changes get made, and we credit contributions
  75. that ship. Documentation and repository tooling accept pull requests directly.
  76. Found a security issue? See [SECURITY.md](./SECURITY.md) — please don't open a public
  77. issue.
  78. ---
  79. ## Questions and support
  80. - See [Add your MCP requests to your collections](https://learning.postman.com/docs/postman-ai-agent-builder/mcp-requests/overview/) to learn how to use Postman to perform MCP requests.
  81. - Visit the [Postman Community](https://community.postman.com/) to share what you've built, ask questions, and get help.
  82. - You can connect to both the remote and local servers and test them using the [Postman MCP Server collection](https://www.postman.com/postman/postman-public-workspace/collection/681dc649440b35935978b8b7).
  83. - Report bugs and request tools in [GitHub Issues](https://github.com/postmanlabs/postman-mcp-server/issues). See [SUPPORT.md](./SUPPORT.md) for which channel fits your question.
  84. ---
  85. ## Keywords
  86. Model Context Protocol · MCP Server · Postman · AI Agents · Claude Code · Cursor · VS Code · Specifications · REST API · API Testing · TypeScript · OpenAPI

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.