postmanlabs/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)

292 ★83 forksTypeScriptUpdated 1d ago

What you need to know

Postman's official MCP server connecting AI agents and coding assistants to Postman workspaces, collections, specifications, and environments - offered as a hosted remote server (OAuth) and an npm-runnable local server, with four tool configurations.

Install

Remote: add https://mcp.postman.com/minimal to any OAuth-compatible MCP host (change /minimal to /code or /mcp for more tools)
Local: npx @postman/postman-mcp-server (add --code or --full for more tools; set POSTMAN_API_KEY env var)
EU region: https://mcp.eu.postman.com/mcp (/code, /minimal) or --region eu flag

Usage

  • Remote server uses OAuth (fully compliant with MCP Authorization spec) - no manual API key config; EU remote and local servers use Postman API key auth (Authorization: Bearer <POSTMAN_API_KEY> header)
  • Choose a tool configuration: Minimal (default, basic ops), Code (client code generation from specs), Full (100+ tools, advanced collaboration/Enterprise), Learn (searches Postman Docs)
  • Use the local server to test local APIs - the remote server has no network access to your workstation
  • Use cases: API testing, code synchronization with collections, collection/workspace/environment management, spec creation, client code generation

Key features

  • Connect to Postman workspaces, collections, API specifications, and environments from the agent
  • Four configurations (Minimal/Code/Full/Learn) to control tool surface and context usage
  • Hosted remote server with OAuth; local npm server for local/private API testing
  • EU region support for data residency; Docker support for local deployment
  • Official Postman collection to explore, test, and connect to the remote and local servers

Best for

Developers who want AI assistants to manage Postman collections, run API tests, and generate client code from their stored API definitions.

Caveats

  • EU remote server and local server support only Postman API key auth (no OAuth on EU)
  • Remote server cannot reach localhost/private APIs - use the local server for those
  • Full mode includes 100+ tools and is aimed at advanced collaboration/Enterprise features
Platforms: Cross-platform (local npx) · Web (remote server)Clients: Claude Code · Claude Desktop · Cursor · VS Code · Codex · Antigravity CLI · GitHub Copilot CLI · Kiro · Docker
Documentation ↗

Reviewed 2026-08-07

Topics

agentaiai-agentsapi-testingclaudeclaude-codecopilotcursorgeminillmmcpmcp-servermodel-context-protocolpostmanrest-apivscode
View on GitHub ↗
Stars
292★
Forks
83
Language
TypeScript
License
Apache-2.0
Created
2025-06-10
Last push
2026-08-05