Back to MCP Catalog

Postman API MCP Server

Developer ToolsTypeScript
Access and manage Postman collections, environments, and APIs
Available Tools

listCollections

List all collections in your Postman workspace

workspaceId

getCollection

Get details of a specific collection

collectionId

createCollection

Create a new collection

namedescriptionworkspaceId

updateCollection

Update an existing collection

collectionIdnamedescription

deleteCollection

Delete a collection

collectionId

listEnvironments

List all environments in your Postman workspace

workspaceId

getEnvironment

Get details of a specific environment

environmentId

createEnvironment

Create a new environment

namevaluesworkspaceId

updateEnvironment

Update an existing environment

environmentIdnamevalues

deleteEnvironment

Delete an environment

environmentId

listApis

List all APIs in your Postman workspace

workspaceId

getApi

Get details of a specific API

apiId

createApi

Create a new API

namedescriptionworkspaceId

updateApi

Update an existing API

apiIdnamedescription

deleteApi

Delete an API

apiId

listWorkspaces

List all workspaces you have access to

getWorkspace

Get details of a specific workspace

workspaceId

The Postman API MCP server provides a comprehensive interface to interact with Postman's powerful API platform. It enables you to programmatically manage collections, environments, APIs, and authentication settings directly through Claude. Built on the official Postman OpenAPI specification, this MCP server gives you full access to Postman's functionality including CRUD operations for collections, environment management, API schema handling, and role-based access controls. Whether you're organizing API documentation, testing endpoints, or managing team permissions, this integration streamlines your workflow.

Getting Started with Postman API

The Postman API MCP server allows you to interact with Postman's platform directly through Claude, giving you programmatic access to collections, environments, APIs, and more.

Prerequisites

Before using the Postman API MCP server, you'll need:

  1. A Postman account
  2. A Postman API key (instructions below)
  3. Node.js and npm/pnpm installed on your system

Obtaining a Postman API Key

  1. Log in to your Postman account at postman.com
  2. Go to your Dashboard and click on your avatar in the top-right corner
  3. Select "Settings" and navigate to the "API Keys" tab
  4. Click "Create API Key", provide a name, and set appropriate scopes
  5. Copy the generated API key for use with the MCP server

Installation Options

Option 1: Using Docker

docker run -p 3000:3000 -e POSTMAN_API_KEY=your_api_key delano/postman-mcp-server

Option 2: Manual Installation

  1. Clone the repository:
git clone https://github.com/delano/postman-mcp-server.git
cd postman-mcp-server
  1. Install dependencies:
pnpm install
  1. Set up your environment variables: Create a .env file in the root directory with:
POSTMAN_API_KEY=your_api_key
  1. Start the server:
pnpm start

Configuring with Claude

To use the Postman API MCP server with Claude Desktop, Cline, or Zed:

  1. Configure the MCP server in your client settings
  2. Set the server URL to http://localhost:3000 (or your custom deployment URL)
  3. Provide your Postman API key when prompted

Usage Examples

Once connected, you can use natural language to interact with Postman:

  • "Create a new collection called 'API Testing'"
  • "Show me all my environments"
  • "Update the 'production' environment to include a new variable"
  • "Get details about my 'User API' collection"
  • "Create a new request in my 'Authentication' folder"

Best Practices

  • Organize Collections: Use folders to keep related requests together
  • Environment Variables: Store sensitive information and environment-specific values as variables
  • Version Control: Use the forking and merging capabilities for collaborative work
  • Documentation: Add descriptions to collections, folders, and requests for better team understanding

Troubleshooting

If you encounter issues:

  1. Verify your API key has the correct permissions
  2. Check that the MCP server is running and accessible
  3. Ensure your requests include all required parameters
  4. Review the server logs for detailed error information

For more information, refer to the Postman API documentation or the MCP server repository.

Related MCPs

Apple Shortcuts
Developer ToolsJavaScript

Control Apple Shortcuts automations from AI assistants

Clojars Dependency Lookup
Developer ToolsJavaScript

Fetch dependency information from Clojars, the Clojure community's artifact repository

Simple Timeserver
Developer ToolsPython

Provides Claude with current time and timezone information

About Model Context Protocol

Model Context Protocol (MCP) allows AI models to access external tools and services, extending their capabilities beyond their training data.

Generate Cursor Documentation

Save time on coding by generating custom documentation and prompts for Cursor IDE.