How to Connect Amplitude to Claude Code

Query your Amplitude data directly from Claude Code using Sequel’s MCP server. Ask questions in plain English, with no SQL, no dashboards, and no context switching.

Short answer

Connect Amplitude to Sequel, then add Sequel's MCP server to Claude Code using the config on this page. Claude Code can then query your live Amplitude data in plain English, with no connector code and no CSV exports. Both steps take a few minutes.

Example prompts

Everything you can ask Claude Code about your Amplitude data.

Ask in plain English — Sequel translates it into a Amplitude query, runs it, and Claude Code hands back the answer. No SQL, no dashboards, no CSV exports.

What you can ask Claude Code
  • What's the 7-day retention for users who signed up last month?
  • Show me the conversion funnel from signup to first paid action over the past 30 days.
  • Which onboarding step has the biggest drop-off?
  • How many users triggered 'Subscription Started' last week, by plan?
  • Daily active users for the past 90 days, segmented by platform.

How it works

Three steps to get started

1

Connect Amplitude to Sequel

In your Sequel dashboard, go to Connections and add Amplitude. Sequel handles authentication and schema discovery automatically.

2

Add Sequel to the agent

Copy the Sequel MCP configuration into Claude Code's settings file (shown below). Swap in your API key from Settings → API Keys.

3

Ask Claude Code about your data

Restart Claude Code and start asking questions. "What's the 7-day retention for users who signed up last month?" — and get a real answer backed by live Amplitude data.

Why Claude Code

What Claude Code does with your Amplitude data

Database access from the terminal

Claude Code can now query your databases as part of agentic coding sessions. Ask it to check schemas, pull sample data, or verify data assumptions — all without leaving the terminal.

Data-aware code generation

When Claude Code knows your actual schema through Sequel, it generates more accurate SQL, migrations, and ORM models — grounded in what's really in your database, not guesses.

Works in any Claude Code session

Once added via CLI, Sequel tools are available in every Claude Code session — interactive, one-shot, or automated. No per-project setup needed.

Configuration

Add Sequel to Claude Code

Place this in claude mcp add (CLI) and replace sql_your_api_key with a key from Settings → API Keys.

claude mcp add (CLI)

claude mcp add --transport http sequel https://api.sequel.sh/mcp \
  --header "Authorization: Bearer sql_your_api_key"

Install

Install Amplitude MCP in Claude Code

Pick your app and Sequel installs itself: a one-click link where the client supports it, that client’s own few steps where it doesn’t. Every route signs in with your Sequel account over OAuth, so there is no API key to copy and nothing to keep in sync.

Already have an MCP client?

https://api.sequel.sh/mcp

Add it as a remote (streamable HTTP) server and sign in when prompted. Skills come with it; nothing else to install. Manual setup per client

Add Sequel to Claude Code

Terminal

claude mcp add --transport http sequel https://api.sequel.sh/mcp
  1. 1Run the command in your terminal. It adds Sequel to the current project; add --scope user for every project.
  2. 2Start Claude Code and run /mcp. Choose sequel and sign in in the browser.
  3. 3Ask a question. Claude Code asks your permission the first time it calls a tool.

Frequently asked questions

How do I connect Amplitude to Claude Code?

You need two things: (1) connect Amplitude to Sequel in your Sequel dashboard under Connections, and (2) add the Sequel MCP config to Claude Code using the setup shown above. Once both are done, Claude Code can query your Amplitude data directly.

What Amplitude data can Claude Code access?

Claude Code can access any data available through your Amplitude connection in Sequel. Use Sequel's search tool to discover available metrics and dimensions, then execute queries to pull the data you need.

Is my Amplitude data sent to Claude Code's servers?

Query results are returned to Claude Code as context within your conversation. Only the data you explicitly ask about is retrieved. Sequel never stores your query results permanently — they exist only for the duration of the tool call.

Do I need a Sequel account?

Yes. You need a Sequel account to connect Amplitude and generate an API key. Sign up free at sequel.sh — no credit card required. Then create a connection to Amplitude and generate an API key from Settings → API Keys.

Can I connect multiple Amplitude accounts?

Yes. Sequel supports multiple connections of the same type. If you have multiple Amplitude accounts or properties, add each as a separate connection in Sequel. Claude Code will be able to query all of them.

How do I add Sequel to Claude Code?

Run the `claude mcp add` command shown above in your terminal. Replace `sql_your_api_key` with a key from Settings → API Keys. The server is added at the default `local` scope (current project only).

How do I make Sequel available across every project?

Add the `--scope user` flag: `claude mcp add --scope user --transport http sequel https://api.sequel.sh/mcp --header "Authorization: Bearer sql_your_api_key"`. User-scope servers are available in every Claude Code session on this machine.

Can I verify Sequel is connected?

Run `claude mcp list` to see all configured MCP servers, or `claude mcp get sequel` to inspect the Sequel config specifically.

Does this work in Claude Code's non-interactive mode?

Yes. Sequel tools are available in both interactive (`claude`) and non-interactive (`claude -p 'your prompt'`) modes. They're also available when using Claude Code via the SDK.

How do I connect Amplitude to Sequel?

Open Amplitude → Settings → Projects → [your project] → General, copy the API Key and Secret Key, pick your region (US or EU), and paste them into Sequel's Amplitude connector. Sequel uses HTTP Basic auth with these keys against Amplitude's read APIs — no OAuth dance required.

Which Amplitude region should I pick?

Use the region the project was created in. US projects live on amplitude.com; EU projects live on analytics.eu.amplitude.com. If queries return 401 or empty results, the region is almost always the culprit — switch it and re-test.

Can Sequel write or modify data in Amplitude?

No. The connector only ships read-only tools: list events, list event properties, get chart, funnel report, retention report, and event segmentation. There is no write endpoint exposed to the agent, so Sequel cannot create events, charts, or cohorts on your behalf.

Do you support saved charts and dashboards?

Yes — if you already built a chart in Amplitude, share its chart ID with Sequel and it will pull the result via the Dashboard REST API, then re-segment or compare it conversationally without you re-creating it.

Connect Amplitude to Claude Code today

Sign up free, connect your data sources, and start querying in minutes.