
How to add PagerDuty MCP to Claude Desktop
PagerDuty's official MCP server — agents triage incidents, manage on-call schedules, and query services from your IDE. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.
Last updated June 14, 2026 · 72★ · stdio · apikey · official
Claude Desktop config for PagerDuty MCP
uvx pagerduty-mcp{
"mcpServers": {
"pagerduty-mcp": {
"command": "uvx",
"args": [
"pagerduty-mcp"
],
"env": {
"PAGERDUTY_USER_API_KEY": "<your-pagerduty-user-api-token>"
}
}
}
}Requires `uv` (the Python package runner). Install it from https://docs.astral.sh/uv/ if `uvx` is not found.
Setup steps
- 1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
- 2Paste the PagerDuty MCP config below under the top-level "mcpServers" key.
- 3Fill in any placeholder secrets (API keys, paths) in the snippet.
- 4Save the file, then fully quit and reopen Claude Desktop.
- 5Open a chat and confirm PagerDuty MCP's tools appear under the 🔌 tools menu.
Before you start
- uv installed globally — the standard config launches the server with uvx
- A PagerDuty User API Token: profile icon → My Profile → User Settings → API Access → Create API User Token
- EU-hosted accounts: PAGERDUTY_API_HOST=https://api.eu.pagerduty.com in env
What PagerDuty MCP can do in Claude Desktop
list_incidentsLists incidents with filtering
get_incidentRetrieves a specific incident
manage_incidentsUpdates incident status, urgency, assignment, or escalation level (write)
create_incidentCreates a new incident (write)
add_note_to_incidentAdds a note to an incident (write)
add_respondersAdds responders to an incident (write)
list_incident_notesLists all notes for a specific incident
list_alerts_from_incidentLists all alerts for an incident with pagination
Security
The server acts with the full permissions of whichever user's API token you configure; it starts read-only and only exposes write tools when launched with --enable-write-tools, and Claude Desktop stores the token in plaintext config, so restrict file permissions. EU accounts must set PAGERDUTY_API_HOST=https://api.eu.pagerduty.com or requests go to the US API.
PagerDuty MCP + Claude Desktop FAQ
Where is the Claude Desktop config file?
Claude Desktop reads MCP servers from ~/Library/Application Support/Claude/claude_desktop_config.json. Paste the PagerDuty MCP config there under the "mcpServers" key and restart the client.
Is PagerDuty MCP safe to use with Claude Desktop?
The server acts with the full permissions of whichever user's API token you configure; it starts read-only and only exposes write tools when launched with --enable-write-tools, and Claude Desktop stores the token in plaintext config, so restrict file permissions. EU accounts must set PAGERDUTY_API_HOST=https://api.eu.pagerduty.com or requests go to the US API.
Is the PagerDuty MCP server official and free?
Yes — it lives in PagerDuty's GitHub org under an Apache-2.0 license and costs nothing beyond your PagerDuty subscription, since it just calls the normal REST API with your User API Token. Support is community-based (GitHub issues and the PagerDuty forum), not part of paid support.
Can it modify or delete things in my PagerDuty account?
Not unless you opt in. The server starts in read-only mode; write tools like create_incident, manage_incidents, delete_team, and status page posts only register when you launch it with the --enable-write-tools flag.
Does it work with EU-hosted PagerDuty accounts?
Yes — set PAGERDUTY_API_HOST=https://api.eu.pagerduty.com in the env block. Without it the server defaults to https://api.pagerduty.com and EU tokens will fail to authenticate.