Postman MCP Server
A Model Context Protocol (MCP) server built with Cloudflare Workers for integration with Claude and other AI assistants
Overview
Postman MCP Server is a Cloudflare Worker that provides API access to Postman collections and environments via the Claude AI MCP (Model Control Plane) interface, enabling seamless integration with AI assistants.
To use the Postman MCP Server, clone the repository, install dependencies, configure your Postman API key, and deploy it to Cloudflare Workers. You can then interact with your Postman collections and environments through the provided API methods.
- API access to Postman collections and environments - Methods for creating, retrieving, and managing collections and environments - Integration with Claude AI for enhanced API testing and management
- Automating API testing workflows with Claude AI.
- Managing Postman collections and environments programmatically.
- Enhancing documentation and testing processes through AI assistance.
Add to your AI client
Use these steps to connect Postman MCP Server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.
Cursor
Add this to your .cursor/mcp.json file in your project root, then restart Cursor.
.cursor/mcp.json
{
"mcpServers": {
"mcp-postman-freebeiro": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-postman-freebeiro"
]
}
}
}Claude Desktop
Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.
~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
"mcpServers": {
"mcp-postman-freebeiro": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-postman-freebeiro"
]
}
}
}Claude Code
Add this to your project's .mcp.json file. Claude Code will detect it automatically.
.mcp.json (project root)
{
"mcpServers": {
"mcp-postman-freebeiro": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-postman-freebeiro"
]
}
}
}VS Code (Copilot)
Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.
.vscode/mcp.json
{
"servers": {
"mcp-postman-freebeiro": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-postman-freebeiro"
]
}
}
}Windsurf
Add this to your Windsurf MCP config file, then restart Windsurf.
~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-postman-freebeiro": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-postman-freebeiro"
]
}
}
}Cline
Open Cline settings, navigate to MCP Servers, and add this server configuration.
Cline MCP Settings (via UI)
{
"mcpServers": {
"mcp-postman-freebeiro": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-mcp-postman-freebeiro"
]
}
}
}FAQ
What is required to run the Postman MCP Server?
You need a Postman API key and a Cloudflare Workers account to deploy the server.
Can I run the server locally?
Yes! You can run the server locally for development using the provided npm commands.
Is there any security concern?
Yes, ensure your Postman API key is stored securely and not committed to version control.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":3069,"uuid":"ea72c1a7-8b43-40c8-b8b7-cfa72912d231","name":"mcp-postman","title":"Postman MCP Server","description":"A Model Context Protocol (MCP) server built with Cloudflare Workers for integration with Claude and other AI assistants","avatar_url":"https://avatars.githubusercontent.com/u/89037908?v=4","created_at":"2025-03-17T02:49:46.830Z","updated_at":"2025-03-17T03:15:56.686Z","status":"created","author_name":"freebeiro","author_avatar_url":"https://avatars.githubusercontent.com/u/89037908?v=4","tags":"[]","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/freebeiro/mcp-postman","target":"_self","content":"$29","summary":"$2a","img_url":null,"type":null,"metadata":"{\"star\":\"1\",\"license\":\"\",\"language\":\"TypeScript\",\"is_official\":false,\"latest_commit_time\":\"2025-03-17 17:16:32\"}","user_uuid":null,"tools":null,"sse_url":null,"sse_provider":null,"sse_params":null,"is_official":false,"server_command":null,"server_params":null,"server_config":null,"allow_call":false,"is_innovation":false,"is_dxt":false,"dxt_manifest":null,"dxt_file_url":null,"is_audit":false},"randomProjects":[],"currentServerKey":"$undefined"}]]}]