Home

Awesome

Postman MCP Server

Version: v0.2.0

An MCP server that provides access to the Postman API. Functionality is based on the official OpenAPI specification. For more information, see the Postman API documentation.

This project is part of the Model Context Protocol (MCP) initiative from Anthropic. For more information, visit the MCP GitHub repository and the announcement on the Anthropic blog.

Skip ahead to install instructions

postman-mcp-server - Cover Image

[!WARNING] This project is currently under active development. Please use with caution and expect breaking changes.

[!NOTE] AI Generated Code. I used Cline v2.2.2 with Claude 3.5 Sonnet (2024-10-22). See docs/README.md for prompts and details about how this code was generated.


Overview

Postman MCP Server is a TypeScript-based MCP server that integrates with the Postman API, providing comprehensive management of Postman collections, environments, and APIs.

Features

Collections

Environments

APIs

Authentication & Authorization

Additional Features

Installation

Prerequisites

Steps

  1. Clone the repository:

    git clone https://github.com/delano/postman-api-server.git
    cd postman-api-server
    
  2. Install dependencies:

    pnpm install
    
  3. Build the server:

    pnpm run build
    
  4. Run in development mode with auto-rebuild:

    pnpm run watch
    

Usage

Setting up API Keys

  1. Generate your API Key

  2. Configure the API Key

    • Add the key to your environment as POSTMAN_API_KEY
    • For Claude Desktop or Cline, include it in your config file (see configuration examples below)
    • Never commit API keys to version control
  3. Verify Access

    • The API key provides access to all Postman resources you have permissions for
    • Test access by running a simple query (e.g., list workspaces)

[!NOTE] If you're using the Postman API collection directly, store your API key as a postman-api-key collection variable.

Using Claude Desktop

To use with Claude Desktop, add the server config:

[!IMPORTANT] If you're updating this provider, Claude must be restarted to pick up API changes from the input schema (i.e. When the MCP server's ToolDefinition elements have changed). This is because Claude caches the tool definitions when it starts up.

<img width="480" alt="claude-desktop-settings" src="https://github.com/user-attachments/assets/7ea7cba2-e27e-413a-a50a-590054d51344" />

Example configuration

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

Using Cline

Using the same example configuration, add the server config to your Cline MCP Servers configuration:

<img width="480" alt="cline-settings" src="https://github.com/user-attachments/assets/651ec517-9aa2-4314-84f5-bee716aa8889" />

Example configuration

Same as Claude above.

Using Zed

I'm still trying to get this to work. From the Zed docs it looks like it needs to be an extension (also this issue #21455).


Documentation

The official Postman API documentation is available in the Postman Public Workspace.

Project Overview

Postman API References & Summaries

This project leverages the Claude model and Cline extension to convert the OpenAPI specification into TypeScript code, enhancing type safety and integration within the MCP server.

This GitHub project includes API References documentation that provides detailed guidance on utilizing the Postman platform programmatically. It covers both the Collection SDK for local development and the Postman API for cloud platform integration. Key topics include authentication mechanisms, rate limits, and in-depth documentation of all API endpoints, including workspaces, collections, environments, mock servers, monitors, and more. Additionally, the guide offers prerequisites and quick-start instructions to facilitate seamless API interactions.

The docs/api/summaries directory contains comprehensive Markdown summaries of the Postman API. These documents outline API endpoints, request/response formats, and implementation details essential for validating and ensuring the functionality of the MCP server. Refer to the API Summaries README for an overview of the documentation structure and implementation strategies.

Converting OpenAPI Spec to TypeScript Code with Claude

Building the MCP Server

Refer to the Handlers Documentation for detailed specifications on implementing MCP server handlers. This includes URI formats, prompt requirements, and resource handling patterns. This guide is crucial for developers working on integrating and enhancing the Postman API functionalities within the MCP server.


Rationale

The MCP wrapper for Postman tools makes sense primarily as an AI interaction layer for complex, multi-step operations where structure and safety are paramount. However, it may be overengineered for simple operations where direct CLI or API usage would suffice. The MCP wrapper provides most value when:

  1. Complex Operations
  1. AI-Driven Automation
  1. Error-Sensitive Operations

It provides less value for:

  1. Simple Operations
  1. Direct CLI Usage

Development

Install dependencies:

pnpm install

Build the server:

pnpm run build

For development with auto-rebuild:

pnpm run watch

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, available as a package script:

pnpm run inspector

Docs

The Inspector will provide a URL to access debugging tools in your browser: http://localhost:5173. You will need to add the POSTMAN_API_KEY before connecting. Navigate to "Tools" to get started.

Other MCP Servers

License

This project is licensed under the MIT License. See the LICENSE file for details.