postman-mcp-server — Claude Code skill: what it does, how to install
Hooks your coding agent up to Postman over MCP: workspaces, collections, environments, request runs and client code generation.
no license 168 installs ★ 9 updated 2026-10-09
npx skills add reason-machines/mcp-skills --skill postman-mcp-server -a claude-codeWhat postman-mcp-server does
The skill wires the agent to Postman's MCP server. Postman hosts a remote endpoint at https://mcp.postman.com, so there is nothing to run locally. The other route is your own process: the package @postman/postman-mcp-server via npx, or the Docker image postman/postman-mcp-server:latest. Go local when the agent has to reach APIs sitting on your machine.
Three toolsets are available. minimal covers the basics, full brings 100+ tools, code searches API definitions and writes client code. You pick one when connecting, then the agent can create workspaces, build collections and requests, edit environment variables, tag things and run collections.
Auth comes down to a Postman key stored in POSTMAN_API_KEY. The US endpoint also accepts OAuth. The EU one at https://mcp.eu.postman.com does not, so an EU workspace needs the key in a header.
What it helps with
- Spin up a workspace for a new team and file the existing collections into it
- Turn an API definition into client code
- Fix environment variables before a collection run
- Search Postman for a public API worth reusing
- Run a collection and read the responses
Example prompts for the agent
- Create a team workspace called
Mobile APIand add a collection for the user endpoints - Update
baseUrlin the Development environment, then run my collection - Generate client code from the API definition in my collection
How to install postman-mcp-server
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill postman-mcp-server -a claude-code2Manually: put the files in place
~/.claude/skills/postman-mcp-server/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/postman-mcp-server/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill postman-mcp-server -a codex2Manually: put the files in place
.agents/skills/postman-mcp-server/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill postman-mcp-server -a cursor2Manually: put the files in place
.cursor/skills/postman-mcp-server/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/mcp-skills skills/postman-mcp-server2Manually: put the files in place
.github/skills/postman-mcp-server/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill postman-mcp-server -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/postman-mcp-serverManually: put the files in place
.devin/skills/postman-mcp-server/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill postman-mcp-server -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about postman-mcp-server
How to install postman-mcp-server in Claude Code?
Run npx skills add reason-machines/mcp-skills --skill postman-mcp-server -a claude-code. The skill then sits at ~/.claude/skills/postman-mcp-server/SKILL.md.
What does postman-mcp-server do?
It gives the agent Postman tools: workspaces, collections and their requests, environments with variables, collection runs. The code toolset adds API definition search and client code generation.
What do I need before using it?
A Postman key in POSTMAN_API_KEY. OAuth is an option on the US remote endpoint; the EU endpoint expects the key only.