Connects AI agents to your Postman collections, OpenAPI specs and environments so they can work with your APIs.
Setup
Choose your client, copy the config, then fill in any required environment variables.
Local
claude mcp add postman --env POSTMAN_API_KEY='<POSTMAN_API_KEY>' -- npx -y @postman/postman-mcp-server~/.codex/config.toml
[mcp_servers.postman]
command = "npx"
args = ["-y", "@postman/postman-mcp-server"]
env = { POSTMAN_API_KEY = "<POSTMAN_API_KEY>" }
# codex mcp add postman --env POSTMAN_API_KEY='<POSTMAN_API_KEY>' -- npx -y @postman/postman-mcp-server~/.cursor/mcp.json
{
"mcpServers": {
"postman": {
"command": "npx",
"args": [
"-y",
"@postman/postman-mcp-server"
],
"env": {
"POSTMAN_API_KEY": "<POSTMAN_API_KEY>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"postman": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@postman/postman-mcp-server"
],
"env": {
"POSTMAN_API_KEY": "<POSTMAN_API_KEY>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"postman": {
"command": "npx",
"args": [
"-y",
"@postman/postman-mcp-server"
],
"env": {
"POSTMAN_API_KEY": "<POSTMAN_API_KEY>"
}
}
}
}claude_desktop_config.json
{
"mcpServers": {
"postman": {
"command": "npx",
"args": [
"-y",
"@postman/postman-mcp-server"
],
"env": {
"POSTMAN_API_KEY": "<POSTMAN_API_KEY>"
}
}
}
}.trae/mcp.json
{
"mcpServers": {
"postman": {
"command": "npx",
"args": [
"-y",
"@postman/postman-mcp-server"
],
"env": {
"POSTMAN_API_KEY": "<POSTMAN_API_KEY>"
}
}
}
}Remote
claude mcp add --transport http postman https://mcp.postman.com/mcp --header 'Authorization: <AUTHORIZATION>'~/.codex/config.toml
[mcp_servers.postman]
url = "https://mcp.postman.com/mcp"
http_headers = { Authorization = "<AUTHORIZATION>" }
# codex mcp add postman --url https://mcp.postman.com/mcp~/.cursor/mcp.json
{
"mcpServers": {
"postman": {
"url": "https://mcp.postman.com/mcp",
"headers": {
"Authorization": "<AUTHORIZATION>"
}
}
}
}.vscode/mcp.json
{
"servers": {
"postman": {
"type": "http",
"url": "https://mcp.postman.com/mcp",
"headers": {
"Authorization": "<AUTHORIZATION>"
}
}
}
}~/.gemini/settings.json
{
"mcpServers": {
"postman": {
"httpUrl": "https://mcp.postman.com/mcp",
"headers": {
"Authorization": "<AUTHORIZATION>"
}
}
}
}claude_desktop_config.json · Customize › Connectors › Add custom connector
{
"mcpServers": {
"postman": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.postman.com/mcp",
"--header",
"Authorization:<AUTHORIZATION>"
]
}
}
}.trae/mcp.json
{
"mcpServers": {
"postman": {
"url": "https://mcp.postman.com/mcp",
"headers": {
"Authorization": "<AUTHORIZATION>"
}
}
}
}Environment variables
POSTMAN_API_KEY
Replace the placeholders with your own credentials and keep them out of version control.