postman

This MCP server integrates Postman directly into your AI conversations, enabling you to manage workspaces, collections, environments, and requests without leaving your chat or agent interface. Once running, you can issue natural language prompts and commands to create workspaces, build collections, import OpenAPI specs, configure environments, and generate mock servers. The server exposes a Postman-backed workflow through MCP-friendly commands, so your AI agent can orchestrate API workflows, synchronize changes in real-time, and keep your API ecosystem organized. To begin, supply your Postman API key to authorize the server and start issuing prompts like: “Create a new workspace for our mobile app project,” “Import this OpenAPI spec into a new collection,” or “Set up dev, staging, and prod environments.” The tools cover workspace management, intelligent collection building, environment control, request engineering, and organization features, all designed to accelerate API development with AI assistance.

Prerequisites

• Node.js v18 or later installed on your machine
• Internet access to install npm packages
• Postman API Key (required for authenticated actions)

Step 1: Install the MCP server globally

npm install -g postman-mcp-server

Step 2: Obtain your Postman API key

• Go to Postman API Keys in your account settings
• Generate a new API key and copy it

Step 3: Run the MCP server (via npx as per quick start)

npx -y postman-mcp-server

Step 4: Configure your MCP client with the API key

• Provide the POSTMAN_API_KEY in your MCP client configuration where required (examples below)

{
  "mcpServers": {
    "postman": {
      "command": "postman-mcp-server",
      "env": {
        "POSTMAN_API_KEY": "your-postman-api-key-here"
      }
    }
  }
}

Notes:

• If you prefer a local install, you can also run the package directly with npm or yarn in your project, but the global npm install is common for MCP servers.
• Ensure your environment variables are available to the MCP client you are using (Cline, Claude Desktop, Cursor, etc.).

Tips and caveats:

• Keep your POSTMAN_API_KEY secure; do not commit it to version control.
• If you encounter authentication errors, re-check the API key permissions in Postman (read/write access as needed).
• The MCP server supports creating workspaces, collections, environments, requests, and mock servers; you can chain actions to automate end-to-end API workflows.
• If you update your API schema or OpenAPI specs, use the import feature to reflect changes in your Postman workspace automatically.
• For troubleshooting, verify that your Node.js version matches the recommended minimum and that the MCP server process has network access to Postman services.