Amami MCP docs

Claude setup

Claude Desktop and Claude Code can call Amami MCP tools after you add a local stdio server entry.

Browser setup first

If you do not already have an API key, run the browser authorization flow:

npx -y amami-analytics-mcp setup --write

The command opens Amami in your browser. You log in or register, click Authorize MCP, and the CLI stores credentials in ~/.amami-analytics-mcp/.env.

Claude Desktop config

After browser setup, add this server:

{
  "mcpServers": {
    "amami": {
      "command": "npx",
      "args": ["-y", "amami-analytics-mcp@latest"]
    }
  }
}

If you prefer a manual API key config:

{
  "mcpServers": {
    "amami": {
      "command": "npx",
      "args": ["-y", "amami-analytics-mcp@latest"],
      "env": {
        "AMAMI_API_KEY": "your_api_key_here"
      }
    }
  }
}

Claude Code command

Claude Code users can add the server from the command line:

claude mcp add amami \
  -e AMAMI_API_KEY=your_amami_api_key \
  -- npx -y amami-analytics-mcp@latest

First query

List my websites, show active visitors, and explain which page needs attention first.