delano/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**
> [!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
* Features
* Collections
* Environments
* APIs
* Authentication \& Authorization
* Additional Features
* Installation
* Prerequisites
* Steps
* Usage
* Setting up API Keys
* Using Claude Desktop
* Using Cline
* Using Zed
* Documentation
* Project Overview
* Rationale
* Development
* Debugging
* Other MCP Servers
* License
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
- **CRUD Operations**: Create, retrieve, update, and delete Postman collections.
- **Folder Management**: Organize requests into folders within collections.
- **Request Management**: Add, update, and delete requests within collections.
- **Response Management**: Manage responses associated with requests.
- **Version Control**: Fork, merge, and pull changes for collections.
- **Comments**: Add and manage comments on collections.
Environments
- **Manage Environments**: Create and retrieve environments for different setups.
- **CRUD Operations**: Full support for creating, updating, and deleting environments.
APIs
- **API Management**: Create, retrieve, update, and delete APIs.
- **Schema Support**: Manage API schemas with multi-file support.
- **Tagging**: Add and manage tags for APIs.
- **Comments**: Add and manage comments on APIs.
Authentication & Authorization
- **API Key Authentication**: Secure access using API keys.
- **Role-Based Access Control**: Manage permissions at workspace and collection levels.
- **Workspace Permissions**: Define permissions specific to workspaces.
Additional Features
- **Private API Network**: Manage elements and folders within a private API network.
- **Webhooks**: Create webhooks to trigger collections with custom payloads.
- **Enterprise Features**: Advanced role controls and SCIM support for enterprise environments.
Installation
Installing via Smithery
To install Postman MCP Server for Claude Desktop automatically via Smithery:
Prerequisites
- Node.js installed.
Steps
1. **Clone the repository:**
2. **Install dependencies:**
3. **Build the server:**
4. **Run in development mode with auto-rebuild:**
Usage
Setting up API Keys
1. **Generate your API Key**
- Visit Postman Account Settings
- Click "Generate API Key"
- Save the key securely - it won't be shown again
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]