drio
Open app

Postman MCP Server

Source

MCP Server for running Postman Collections with Newman

Catalog onlyCatalog onlySTDIO

Overview

Postman MCP Server is an MCP (Model Context Protocol) server that enables running Postman collections using Newman, allowing LLMs to execute API tests and obtain detailed results through a standardized interface.

To use the Postman MCP Server, install it via Smithery or manually clone the repository, install dependencies, and configure it in your Claude desktop configuration file. You can then run Postman collections by invoking the server with the appropriate commands.

  • Run Postman collections using Newman - Support for environment files and global variables - Detailed test results including overall success/failure status, test summary, detailed failure information, and execution timings.
  1. Automating API testing for development workflows.
  2. Integrating API tests into CI/CD pipelines.
  3. Running tests for multiple environments using different configurations.

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-shannonlal": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-postman-shannonlal"
      ]
    }
  }
}

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-shannonlal": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-postman-shannonlal"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "mcp-postman-shannonlal": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-postman-shannonlal"
      ]
    }
  }
}

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-shannonlal": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-postman-shannonlal"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-postman-shannonlal": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-postman-shannonlal"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "mcp-postman-shannonlal": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-mcp-postman-shannonlal"
      ]
    }
  }
}

FAQ

Can I run any Postman collection?

Yes! You can run any Postman collection as long as you provide the correct path or URL.

Is there support for custom environment variables?

Yes! The server supports custom environment files and global variables.

How do I get the test results?

The server returns detailed test results including success/failure status and execution timings.7:["$","div",null,{"className":"container mx-auto flex flex-col gap-4","children":["$L26","$L27",["$","$L28",null,{"currentProject":{"id":949,"uuid":"42ea627b-1c26-41f8-a8af-9c468aca65ae","name":"mcp-postman","title":"Postman MCP Server","description":"MCP Server for running Postman Collections with Newman","avatar_url":"https://avatars.githubusercontent.com/u/2457835?v=4","created_at":"2025-01-28T02:19:59.606Z","updated_at":"2025-02-23T07:19:16.617Z","status":"created","author_name":"shannonlal","author_avatar_url":"https://avatars.githubusercontent.com/u/2457835?v=4","tags":"[]","category":"developer-tools","is_featured":false,"sort":1,"url":"https://github.com/shannonlal/mcp-postman","target":"_self","content":"$29","summary":"$2a","img_url":"https://camo.githubusercontent.com/0119870c16ab7d1f7a12e635b3d5fe9e868da32a863b1f9617c14f25bcc8984d/68747470733a2f2f736d6974686572792e61692f62616467652f6d63702d706f73746d616e","type":null,"metadata":"{\"star\":\"26\",\"license\":\"MIT license\",\"language\":\"TypeScript\",\"is_official\":false,\"latest_commit_time\":\"2025-02-05 14:49:05\"}","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"}]]}]

Developer tools