Plausible Analytics MCP Server
Enables AI assistants to query website statistics from Plausible Analytics, providing access to metrics like real-time visitors, traffic trends, and page performance. It supports both Plausible Cloud and self-hosted instances through the Stats API v2.
Ask AI about Plausible Analytics MCP Server
Powered by Claude Β· Grounded in docs
I know everything about Plausible Analytics MCP Server. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
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
