How to add Postman MCP Server to Windsurf

Manage Postman collections, environments, and APIs through the Postman API. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 14, 2026 · 155★ · stdio · apikey

Windsurf config for Postman MCP Server

npx -y @smithery/cli install postman-api-server --client claude

{
  "mcpServers": {
    "postman-mcp-server": {
      "command": "node",
      "args": [
        "/path/to/postman-api-server/build/index.js"
      ],
      "env": {
        "POSTMAN_API_KEY": "CHANGEME"
      }
    }
  }
}

Setup steps

1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
2Paste the Postman MCP Server config below.
3Fill in placeholder secrets, then save.
4Click Refresh in the MCP panel.
5Postman MCP Server's tools become available to Cascade.

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)

What Postman MCP Server can do in Windsurf

Collections

Create, 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.

Environments

Create and retrieve environments for different setups, with full CRUD support for creating, updating, and deleting environments.

APIs

Create, retrieve, update, and delete APIs; manage API schemas with multi-file support; add and manage tags; and add/manage comments on APIs.

Authentication & Authorization

API key authentication, role-based access control, and workspace-level permissions management.

Workspaces

Manage Postman workspaces and workspace-specific permissions.

Mocks

Manage Postman mock servers.

Monitors

Manage Postman monitors for scheduled collection runs.

Users

Retrieve user and account information.

Security

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 + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the Postman MCP Server config there under the "mcpServers" key and restart the client.

Is Postman MCP Server safe to use with Windsurf?

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.

View repo Full Postman MCP Server page