# postman-mcp-server

Hooks your coding agent up to Postman over MCP: workspaces, collections, environments, request runs and client code generation.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 168 installs · ★ 9 repo stars
- Author: reason-machines
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/reason-machines/mcp-skills/tree/HEAD/skills/postman-mcp-server/SKILL.md
- Updated: 2026-10-09
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/postman-mcp-server

## What it 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.

## Requirements
- Works with: Postman

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill postman-mcp-server -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/postman-mcp-server/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/postman-mcp-server/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill postman-mcp-server -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/postman-mcp-server/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill postman-mcp-server -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/postman-mcp-server/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install reason-machines/mcp-skills skills/postman-mcp-server
```

2. **Manually: put the files in place**
- File: `.github/skills/postman-mcp-server/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill postman-mcp-server -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/postman-mcp-server
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/postman-mcp-server/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill postman-mcp-server -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/reason-machines/mcp-skills/tree/HEAD/skills/postman-mcp-server/SKILL.md

## When to use it
- 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
- Create a team workspace called `Mobile API` and add a collection for the user endpoints
- Update `baseUrl` in the Development environment, then run my collection
- Generate client code from the API definition in my collection

## Similar
- [postman](https://affpapa.org/en/nevibecode/plugins/postman.md) — plugin · ★ 41 repo stars
- [postman-collection-generator](https://affpapa.org/en/nevibecode/skills/postman-collection-generator.md) — skill · 703 installs
- [Postman MCP Server](https://affpapa.org/en/nevibecode/mcp/postman-mcp-server.md) — MCP server · ★ 332 repo stars
- [pp-postman-explore](https://affpapa.org/en/nevibecode/skills/pp-postman-explore.md) — skill · 128 installs
- [performing-api-security-testing-with-postman](https://affpapa.org/en/nevibecode/skills/performing-api-security-testing-with-postman.md) — skill · 240 installs
- [casely](https://affpapa.org/en/nevibecode/skills/casely.md) — skill · 921 installs

From the same set: [reason-machines/mcp-skills](https://affpapa.org/en/nevibecode/by/reason-machines/mcp-skills.md) — 98 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
