plausible-mcp

An MCP (Model Context Protocol) server for Plausible Analytics. Query your website stats directly from AI assistants like Claude.

Features

• Aggregate stats — visitors, pageviews, bounce rate, visit duration
• Time series — traffic trends by day, week, or month
• Breakdowns — top pages, traffic sources, countries, devices, browsers, and more
• Real-time visitors — current visitor count
• Site listing — discover all your Plausible sites
• Raw query — full access to the Plausible Stats API v2 for advanced use cases

Works with both Plausible Cloud and self-hosted instances.

Setup

1. Get a Plausible API key

Go to your Plausible account settings and create an API key.

2. Configure your MCP client

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "plausible": {
      "command": "npx",
      "args": ["-y", "plausible-mcp"],
      "env": {
        "PLAUSIBLE_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code

claude mcp add plausible -- npx -y plausible-mcp

Then set the environment variable PLAUSIBLE_API_KEY in your shell.

Self-hosted Plausible

Add PLAUSIBLE_BASE_URL to point to your instance:

{
  "env": {
    "PLAUSIBLE_API_KEY": "your-api-key-here",
    "PLAUSIBLE_BASE_URL": "https://plausible.example.com"
  }
}

Tools

Tool	Description
list-sites	List all sites in your Plausible account
get-current-visitors	Real-time visitor count for a site
get-aggregate-stats	Summary metrics over a time period
get-timeseries	Traffic trends over time (by day/week/month)
get-breakdown	Break down stats by dimension (pages, sources, countries, etc.)
query	Raw Plausible Stats API v2 query for advanced use cases

Example prompts

• "How many visitors did example.com get this month?"
• "Show me traffic trends for the last 30 days"
• "What are my top 10 pages?"
• "Where is my traffic coming from?"
• "Compare this month's visitors to last month"
• "How many people are on my site right now?"

Environment variables

Variable	Required	Default	Description
PLAUSIBLE_API_KEY	Yes	—	Your Plausible API key
PLAUSIBLE_BASE_URL	No	https://plausible.io	Base URL for self-hosted instances

Development

git clone https://github.com/Defilan/plausible-mcp.git
cd plausible-mcp
npm install
npm run build

To test locally:

PLAUSIBLE_API_KEY=your-key node dist/index.js

License

MIT