
Postman MCP Server
Manage Postman collections, environments, and APIs through the Postman API.
Add to your client
Copy the config for your MCP client and paste it into its config file.
npx -y @smithery/cli install postman-api-server --client claudePaste into ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"postman-mcp-server": {
"command": "node",
"args": [
"/path/to/postman-api-server/build/index.js"
],
"env": {
"POSTMAN_API_KEY": "CHANGEME"
}
}
}
}Step-by-step guides: Add to Claude Desktop · Add to Cursor · Add to Windsurf
Before you start
- Node.js installed
- A Postman API key set as POSTMAN_API_KEY
- Clone and build the repository with pnpm (pnpm install, pnpm run build)
About Postman MCP Server
Postman MCP Server is a TypeScript-based MCP server that integrates with the Postman API, providing comprehensive management of Postman collections, environments, and APIs. Functionality is derived from the official Postman OpenAPI specification. It exposes tool groups for collections, environments, APIs, authentication/authorization, mocks, monitors, users, workspaces, and additional features such as webhooks and the private API network. It runs over stdio and is intended for use with MCP clients like Claude Desktop and Cline.
Tools & capabilities (9)
CollectionsCreate, retrieve, update, and delete Postman collections; manage folders, requests, and responses within collections; fork, merge, and pull changes for version control; and add/manage comments.
EnvironmentsCreate and retrieve environments for different setups, with full CRUD support for creating, updating, and deleting environments.
APIsCreate, retrieve, update, and delete APIs; manage API schemas with multi-file support; add and manage tags; and add/manage comments on APIs.
Authentication & AuthorizationAPI key authentication, role-based access control, and workspace-level permissions management.
WorkspacesManage Postman workspaces and workspace-specific permissions.
MocksManage Postman mock servers.
MonitorsManage Postman monitors for scheduled collection runs.
UsersRetrieve user and account information.
Additional FeaturesManage elements and folders within a private API network, create webhooks to trigger collections with custom payloads, and enterprise features including advanced role controls and SCIM support.
When to use it
- AI-driven automated API testing workflows
- Maintaining and updating API documentation
- Managing and coordinating multiple collections and environments
- Generating comprehensive reports across Postman resources
- Error-sensitive operations such as critical API testing, production deployments, and compliance checking
Security notes
Requires a Postman API key (POSTMAN_API_KEY). The key grants access to all Postman resources you have permissions for. Never commit API keys to version control. Generate a key at https://go.postman.co/settings/me/api-keys.
Postman MCP Server FAQ
How do I authenticate?
Generate a Postman API key at https://go.postman.co/settings/me/api-keys and provide it via the POSTMAN_API_KEY environment variable in your MCP client config.
Is this an official Postman product?
No. It is a community project by delano, built on Postman's official OpenAPI specification. It is part of the broader MCP initiative and licensed under MIT.
How do I install it?
You can install it for Claude Desktop automatically via Smithery (npx -y @smithery/cli install postman-api-server --client claude), or clone the repo and build it with pnpm, then point your MCP client at build/index.js with node.
Which MCP clients are supported?
The README documents configuration for Claude Desktop and Cline using the same mcpServers config block. Zed support was noted as not yet working.
Alternatives to Postman MCP Server
Compare all alternatives →Microsoft's official browser-automation MCP using Playwright's accessibility tree (no vision model).
Up-to-date, version-specific library documentation injected into your coding agent.
LSP-powered coding agent toolkit: semantic symbol search, references and structural edits.
Compare Postman MCP Server with: