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

What is 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)

Overview of postman-mcp-server

What it is

Postman MCP Server implements the Model Context Protocol (MCP) to connect AI agents and coding assistants — including Claude Code, Cursor, VS Code Copilot, GitHub Copilot CLI, and Gemini CLI — directly to Postman workspaces, collections, specifications, and environments. It is available as an npm package and is licensed under Apache-2.0.

Key features

  • Supports four tool configurations: Minimal (default), Code, Full (100+ tools), and Learn (searches Postman Docs).
  • Remote server at https://mcp.postman.com with OAuth authentication; EU remote server and local server support API key authentication.
  • Local server can be run via npx @postman/postman-mcp-server with optional --code, --full, or --region eu flags.
  • EU region support: remote server available at https://mcp.eu.postman.com/mcp (Full), /code, and /minimal; STDIO package uses --region eu flag or POSTMAN_API_BASE_URL environment variable.
  • Docker setup available (see DOCKER.md).
  • Bug reports, tool requests, and documentation fixes are welcome via GitHub Issues; changes to src/ are synced from Postman's internal source of truth and cannot be merged directly.

Use cases

  • API Testing — Continuously test your API using your Postman collection; use the local server to test local APIs.
  • Code synchronization — Keep your code in sync with Postman Collections and specs.
  • Collection management — Create and tag collections, update documentation, add comments, or perform actions across multiple collections without leaving your editor.
  • Workspace and environment management — Create workspaces and environments, plus manage environment variables.
  • Automatic spec creation — Create specs from your code and use them to generate collections.
  • Client code generation — Generate production-ready client code that consumes APIs following best practices and project conventions.

Getting started

Remote (any OAuth-compatible MCP host):Add this URL to your MCP host's configuration:bashhttps://mcp.postman.com/minimalChange /minimal to /code or /mcp for Code or Full mode. For EU or API key auth, pass Authorization: Bearer as a header.Local:bashnpx @postman/postman-mcp-serverAdd --code or --full for Code or Full mode. Set POSTMAN_API_KEY as an environment variable.For IDE-specific setup instructions, see the Postman MCP Server docs.

License and pricing

License: Apache-2.0. Pricing: open source (not stated as paid).

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/postmanlabspostman-mcp-server.svg)](https://yunodb.com/tools/postmanlabspostman-mcp-server?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/postmanlabspostman-mcp-server?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/postmanlabspostman-mcp-server.svg" alt="Featured on YunoDB" height="20"></a>