
How to add Amplitude MCP to Claude Desktop
Amplitude's hosted MCP server — query charts, dashboards, experiments, flags, and session replays in plain English. Paste the config into ~/Library/Application Support/Claude/claude_desktop_config.json and restart Claude Desktop.
Last updated June 14, 2026 · 45★ · http · oauth · official
Claude Desktop config for Amplitude MCP
claude mcp add --transport http amplitude https://mcp.amplitude.com/mcp{
"mcpServers": {
"amplitude-mcp": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.amplitude.com/mcp"
]
}
}
}Claude Desktop connects to remote servers through the `mcp-remote` proxy (installed on first run via npx). Restart Claude Desktop after saving.
Setup steps
- 1Open Claude Desktop → Settings → Developer → Edit Config (this opens ~/Library/Application Support/Claude/claude_desktop_config.json).
- 2Paste the Amplitude 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 Amplitude MCP's tools appear under the 🔌 tools menu.
Before you start
- An Amplitude account with access to at least one project
- Appropriate project permissions in Amplitude — the server can't show anything your user can't see
- An MCP client that supports remote HTTP servers with OAuth (Claude, Cursor, ChatGPT, etc.)
What Amplitude MCP can do in Claude Desktop
searchFind dashboards, charts, notebooks, and experiments
query_chartRetrieve data from specific charts
query_experimentAnalyze experiment results and statistical significance
query_datasetExecute custom analytics queries
query_metricGet data for specific metrics
get_chartsRetrieve full chart definitions
get_dashboardAccess dashboard content and layout
get_notebookFetch notebook content with charts and analysis
Security
Auth is OAuth 2.0 scoped to your existing Amplitude permissions — there is no API key to store, and organization admins can control MCP server access. Your analytics data is processed by whichever third-party AI model your client uses, so check your org's AI data-processing policy before connecting.
Amplitude 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 Amplitude MCP config there under the "mcpServers" key and restart the client.
Is Amplitude MCP safe to use with Claude Desktop?
Auth is OAuth 2.0 scoped to your existing Amplitude permissions — there is no API key to store, and organization admins can control MCP server access. Your analytics data is processed by whichever third-party AI model your client uses, so check your org's AI data-processing policy before connecting.
Is the Amplitude MCP server free and safe to connect?
It's included with your Amplitude account — no separate charge is documented, though the beta may enforce rate limits. Access is OAuth-scoped to your existing permissions and admins can disable MCP org-wide; the main consideration is that query results flow through your AI client's model, so review your data-processing policy.
Do I need an API key?
No. Authentication is OAuth 2.0 — the client opens a browser login and tokens are managed for you. That also means agent access always follows a real Amplitude user, not a shared key you'd have to rotate.
Which endpoint should EU customers use?
https://mcp.eu.amplitude.com/mcp. The server URL must match your org's data residency region — pointing an EU org at the US endpoint results in authentication/connection errors.