Plausible Analytics MCP Server

MCP server for Plausible Analytics — privacy-friendly web analytics. Query traffic, conversions, sources, and device breakdowns from any MCP-compatible AI assistant.

Features

• Flexible stats queries — metrics, dimensions, filters, date ranges

• Real-time visitors — live visitor count

• Traffic breakdowns — sources, countries, browsers, UTM campaigns

• Time-series data — daily, weekly, monthly, hourly intervals

• Custom events — event tracking and conversion rates

• Entry/exit pages — where visitors land and leave

• Device analytics — browser, OS, screen size breakdowns

• Goal tracking — conversion stats for all configured goals

• Site management — list and inspect sites

Related MCP server: plausible-whenever-mcp

12 Tools

Setup

Prerequisites

1. A Plausible Analytics account (cloud or self-hosted)

2. An API key — generate one at Site Settings → API Keys in your Plausible dashboard

Configuration

Add to your MCP client config (e.g. Claude Desktop, Cursor):

{
  "mcpServers": {
    "plausible": {
      "command": "node",
      "args": ["/path/to/plausible-mcp-server/dist/index.js"],
      "env": {
        "PLAUSIBLE_API_KEY": "your-api-key-here"
      }
    }
  }
}

For self-hosted Plausible, also set:

"env": {
  "PLAUSIBLE_API_KEY": "your-api-key",
  "PLAUSIBLE_API_BASE": "https://your-plausible-instance.com"
}

Build from source

git clone https://github.com/friendlygeorge/plausible-mcp-server.git
cd plausible-mcp-server
npm install
npx tsc

Usage Examples

Once configured, ask your AI assistant:

• "Show me the top traffic sources for my site this month"

• "How many visitors did I get today?"

• "What's the time-series of pageviews for the last 30 days?"

• "Which pages have the highest bounce rate?"

• "Show me UTM campaign performance"

• "What are my top entry pages?"

• "Show conversion rates for all goals"

• "Break down visitors by country for the last week"

Environment Variables

Supported Metrics

visitors, visits, pageviews, views_per_visit, visit_duration, events, bounce_rate, scroll_depth, conversion_rate

Supported Dimensions

visit:source, visit:referrer, visit:utm_source, visit:utm_medium, visit:utm_campaign, visit:utm_content, visit:utm_term, visit:country_name, visit:city_name, visit:screen, visit:browser, visit:browser_version, visit:os, visit:os_version, visit:entry_page, visit:exit_page, event:page, event:name, event:goal, event:props:<key>

License

MIT