Set up a remote Postman MCP server

The US remote server supports OAuth for the best developer experience and fastest setup, and doesn’t require an API key. OAuth provides stronger security and access control compared to a static API key. It’s MCP specification-compliant, including Dynamic Client Registration (DCR), OAuth metadata, and PKCE.

MCP hosts that support OAuth can discover and use it automatically for all tools. The US remote server also accepts a Postman API key (Bearer token in the Authorization header).

The EU remote server only supports API key authentication. Pass your Postman API key as a Bearer token in the Authorization header.

The US remote server supports OAuth and doesn’t require a key. To use API key authentication instead, generate a Postman API key.

Generate a Postman API key before starting.

Claude Code automatically uses OAuth for the best installation experience. To use an API key instead, add the --header flag.

OAuth

Run one of the following commands in your terminal:

$
claude mcp add --transport http postman https://mcp.postman.com/minimal

API key

Run one of the following commands in your terminal:

$
claude mcp add --transport http postman https://mcp.postman.com/minimal --header "Authorization: Bearer <POSTMAN_API_KEY>"

Pass your Postman API key as a Bearer token using the --header flag:

$
claude mcp add --transport http postman https://mcp.eu.postman.com/minimal --header "Authorization: Bearer <POSTMAN_API_KEY>"

Click the button to install the remote Postman MCP server in Cursor:

Manual installation

To configure the server by hand, add one of the following JSON blocks to your .cursor/mcp.json file.

OAuth

Omit the headers object entirely and Cursor completes the OAuth flow for you. This is the fastest setup:

1
{
2
    "mcpServers": {
3
        "postman": {
4
            "url": "https://mcp.postman.com/minimal"
5
        }
6
    }
7
}

API key

To use API key authentication, add an Authorization header in Bearer <POSTMAN_API_KEY> format:

1
{
2
    "mcpServers": {
3
        "postman": {
4
            "url": "https://mcp.postman.com/minimal",
5
            "headers": { "Authorization": "Bearer <POSTMAN_API_KEY>" }
6
        }
7
    }
8
}

The Cursor one-click install button is configured for the US region. To configure the server for the EU region, use the manual installation instructions below.

Manual installation

Add one of the following JSON blocks to your .cursor/mcp.json file, using an Authorization header in Bearer <POSTMAN_API_KEY> format:

1
{
2
    "mcpServers": {
3
        "postman": {
4
            "url": "https://mcp.eu.postman.com/minimal",
5
            "headers": { "Authorization": "Bearer <POSTMAN_API_KEY>" }
6
        }
7
    }
8
}

To install the remote Postman MCP server in VS Code, click the install button or use the Postman VS Code Extension:

To access Full mode, change the url value to https://mcp.postman.com/mcp in the mcp.json file. To access Code mode, change the value to https://mcp.postman.com/code in this file.

Manual installation

You can use the Postman MCP server with MCP-compatible extensions in VS Code, such as GitHub Copilot, Claude for VS Code, or other AI assistants that support MCP.

OAuth

Add one of the following JSON blocks to the .vscode/mcp.json configuration file:

1
{
2
    "servers": {
3
        "postman": {
4
            "type": "http",
5
            "url": "https://mcp.postman.com/minimal"
6
        }
7
    }
8
}

Start the server. When prompted, complete the OAuth sign-in flow.

API key

Use one of the following JSON blocks in the .vscode/mcp.json configuration file:

1
{
2
    "servers": {
3
        "postman": {
4
            "type": "http",
5
            "url": "https://mcp.postman.com/minimal",
6
            "headers": {
7
                "Authorization": "Bearer ${input:postman-api-key}"
8
            }
9
        }
10
    },
11
    "inputs": [
12
        {
13
            "id": "postman-api-key",
14
            "type": "promptString",
15
            "description": "Enter your Postman API key"
16
        }
17
    ]
18
}

Start the server. When prompted, enter your Postman API key.

The VS Code one-click install button is configured for the US region. To configure the server for the EU region, use the manual installation instructions below.

Manual installation

Add one of the following JSON blocks to the .vscode/mcp.json configuration file, using an Authorization header in Bearer <POSTMAN_API_KEY> format:

1
{
2
    "servers": {
3
        "postman": {
4
            "type": "http",
5
            "url": "https://mcp.eu.postman.com/minimal",
6
            "headers": {
7
                "Authorization": "Bearer ${input:postman-api-key}"
8
            }
9
        }
10
    },
11
    "inputs": [
12
        {
13
            "id": "postman-api-key",
14
            "type": "promptString",
15
            "description": "Enter your Postman API key"
16
        }
17
    ]
18
}

Start the server. When prompted, enter your Postman API key.

OAuth

Use OAuth for the best installation experience. It requires no manual API key setup:

$
codex mcp add postman --url https://mcp.postman.com/minimal

API key

Codex CLI reads the key from an environment variable rather than taking it inline, so export it first:

$
export POSTMAN_API_KEY=<POSTMAN_API_KEY>

Then add the remote server with --bearer-token-env-var, naming the variable to read:

$
codex mcp add postman --url https://mcp.postman.com/minimal --bearer-token-env-var POSTMAN_API_KEY

Codex CLI reads the API key from an environment variable rather than taking it inline, so export it first:

$
export POSTMAN_API_KEY=<POSTMAN_API_KEY>

Then add the remote server with --bearer-token-env-var, naming the variable to read:

$
codex mcp add postman --url https://mcp.eu.postman.com/minimal --bearer-token-env-var POSTMAN_API_KEY

1
[mcp_servers.postman]
2
url = "https://mcp.postman.com/minimal"
3
bearer_token_env_var = "POSTMAN_API_KEY"

Change the url value to select a different tool configuration. Omit bearer_token_env_var to use OAuth. If you need to send a header other than Authorization, use the http_headers or env_http_headers keys instead.

1
[mcp_servers.postman]
2
url = "https://mcp.eu.postman.com/minimal"
3
bearer_token_env_var = "POSTMAN_API_KEY"

Change the url value to select a different tool configuration. If you need to send a header other than Authorization, use the http_headers or env_http_headers keys instead.

The extension connects to the remote server with OAuth using the Minimal tool configuration by default. To switch configurations, run /postman:use-remote with the minimal, code, full, or learn configuration:

$
/postman:use-remote full

For more information, see the Postman Antigravity CLI extension.

If you prefer API key authentication to OAuth, edit the mcp_config.json file in the installed extension directory and add an Authorization header to the server entry. Note that this file uses serverUrl rather than url:

1
{
2
    "mcpServers": {
3
        "postman": {
4
            "serverUrl": "https://mcp.postman.com/minimal",
5
            "headers": {
6
                "Authorization": "Bearer <POSTMAN_API_KEY>"
7
            }
8
        }
9
    }
10
}

Change the serverUrl path to use a different tool configuration: /minimal, /code, /mcp (Full), or /learn.

Edit the mcp_config.json file in the installed extension directory and add an Authorization header to the server entry. Note that this file uses serverUrl rather than url:

1
{
2
    "mcpServers": {
3
        "postman": {
4
            "serverUrl": "https://mcp.eu.postman.com/minimal",
5
            "headers": {
6
                "Authorization": "Bearer <POSTMAN_API_KEY>"
7
            }
8
        }
9
    }
10
}

Change the serverUrl path to select a different tool configuration: /minimal, /code, /mcp (Full), or /learn.

For more information, see the Postman Antigravity CLI extension.

You can add the MCP server to Copilot CLI with OAuth (recommended) or an API key.

Add the MCP server to Copilot CLI using API key authentication.

To add it non-interactively, run one of the following commands in your terminal. Copilot CLI completes the OAuth flow for you:

$
copilot mcp add --transport http postman https://mcp.postman.com/minimal

To use an API key instead, add the --header flag:

$
copilot mcp add --transport http postman https://mcp.postman.com/minimal --header "Authorization: Bearer <POSTMAN_API_KEY>"

To add it non-interactively, run the following command in your terminal:

$
copilot mcp add --transport http postman https://mcp.eu.postman.com/minimal --header "Authorization: Bearer <POSTMAN_API_KEY>"

1
{
2
    "mcpServers": {
3
        "postman": {
4
            "type": "http",
5
            "url": "https://mcp.postman.com/minimal",
6
            "tools": [
7
                "*"
8
            ]
9
        }
10
    }
11
}

API key

To use API key authentication, add an Authorization header in Bearer <POSTMAN_API_KEY> format:

1
{
2
    "mcpServers": {
3
        "postman": {
4
            "type": "http",
5
            "url": "https://mcp.postman.com/minimal",
6
            "headers": {
7
                "Authorization": "Bearer <POSTMAN_API_KEY>"
8
            },
9
            "tools": [
10
                "*"
11
            ]
12
        }
13
    }
14
}

Add an Authorization header in Bearer <POSTMAN_API_KEY> format:

1
{
2
    "mcpServers": {
3
        "postman": {
4
            "type": "http",
5
            "url": "https://mcp.eu.postman.com/minimal",
6
            "headers": {
7
                "Authorization": "Bearer <POSTMAN_API_KEY>"
8
            },
9
            "tools": [
10
                "*"
11
            ]
12
        }
13
    }
14
}

To install the remote Postman MCP server in Kiro, click the install button for the tool configuration that you want to use:

Minimal	Code	Full	Learn

Manual installation

To configure the server by hand, add the following to Kiro’s mcp.json file. Omit the headers object and Kiro completes the OAuth flow for you:

1
{
2
    "mcpServers": {
3
        "postman": {
4
            "url": "https://mcp.postman.com/minimal",
5
            "disabled": false,
6
            "autoApprove": []
7
        }
8
    }
9
}

Change the url path to select a different tool configuration: /minimal, /code, /mcp (Full), or /learn.

API key

To use API key authentication, add an Authorization header in Bearer <POSTMAN_API_KEY> format:

1
{
2
    "mcpServers": {
3
        "postman": {
4
            "url": "https://mcp.postman.com/minimal",
5
            "headers": { "Authorization": "Bearer <POSTMAN_API_KEY>" },
6
            "disabled": false,
7
            "autoApprove": []
8
        }
9
    }
10
}

The Kiro one-click install buttons are configured for the US region. To configure the server for the EU region, use the manual installation instructions below.

Manual installation

Add the following to Kiro’s mcp.json file, using an Authorization header in Bearer <POSTMAN_API_KEY> format:

1
{
2
    "mcpServers": {
3
        "postman": {
4
            "url": "https://mcp.eu.postman.com/minimal",
5
            "headers": { "Authorization": "Bearer <POSTMAN_API_KEY>" },
6
            "disabled": false,
7
            "autoApprove": []
8
        }
9
    }
10
}

Change the url path to select a different tool configuration: /minimal, /code, /mcp (Full), or /learn.