English Français العربية

Plausible Analytics MCP

Official registry Marketing and sales

Plausible Analytics MCP: privacy-first website stats, real-time visitors, breakdowns, and trends.

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package plausible-mcp
Claude Code 
claude mcp add plausible-analytics-mcp -e 'PLAUSIBLE_API_KEY=<PLAUSIBLE_API_KEY>' -e 'PLAUSIBLE_SITE_ID=<PLAUSIBLE_SITE_ID>' -e 'PLAUSIBLE_BASE_URL=<PLAUSIBLE_BASE_URL>' -- uvx plausible-mcp==0.1.3
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "plausible-analytics-mcp": {
            "command": "uvx",
            "args": [
                "plausible-mcp==0.1.3"
            ],
            "env": {
                "PLAUSIBLE_API_KEY": "<PLAUSIBLE_API_KEY>",
                "PLAUSIBLE_SITE_ID": "<PLAUSIBLE_SITE_ID>",
                "PLAUSIBLE_BASE_URL": "<PLAUSIBLE_BASE_URL>"
            }
        }
    }
}

Environment variables

  • PLAUSIBLE_API_KEY Plausible Analytics API token
  • PLAUSIBLE_SITE_ID Default Plausible site domain / ID (e.g. yourdomain.com)
  • PLAUSIBLE_BASE_URL Custom self-hosted Plausible instance URL (default: https://plausible.io)

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. plausible-mcp
  2. Quick Start
  3. Environment Configuration
  4. Available Tools
  5. Error Absorption Standard
  6. MCP Client Setup
  7. License

plausible-mcp

Fast, privacy-first Plausible Analytics Model Context Protocol (MCP) server for AI coding agents and LLM harnesses. Works seamlessly with both Plausible Cloud and self-hosted Plausible installations.

Quick Start

Run with uvx (Python)
export PLAUSIBLE_API_KEY="your_api_key_here"
uvx plausible-mcp
Run with npx (Node / npm bridge)
export PLAUSIBLE_API_KEY="your_api_key_here"
npx -y plausible-analytics-mcp

Environment Configuration

VariableDescriptionDefault
PLAUSIBLE_API_KEYYour Plausible Stats/Sites API tokenRequired (or pass via tool token arg)
PLAUSIBLE_BASE_URLBase URL for self-hosted Plausiblehttps://plausible.io
DO_NOT_TRACKSet to 1 to disable anonymous telemetry0
Getting an API Key
  1. Log in to Plausible (Cloud or your self-hosted instance).
  2. Go to Settings (user profile menu) -> API Keys.
  3. Click + New Key, name it mcp-agent, and copy the token.
  4. Export as PLAUSIBLE_API_KEY="your_token".

Available Tools

ToolDescription
get_aggregate_stats(site_id, date_range="30d", metrics=None, token=None)High-level visitor, pageview, bounce rate, and session duration totals
get_breakdown(site_id, property_name="event:page", date_range="30d", limit=20, token=None)Segment metrics by pages, traffic sources, countries, browsers, OS, devices
get_realtime_visitors(site_id, token=None)Current count of active visitors on the site right now
get_timeseries(site_id, date_range="30d", interval="date", token=None)Daily or monthly trendline data points for chart generation
doctor(token=None)Test Plausible API connectivity and validate the configured API token
skills_list()List dynamic analytics playbooks and methodology guides
skill_read(name)Fetch full markdown playbook by name (e.g. plausible-overview, analytics-recipes)
check_for_updates()Check PyPI for newer versions and view upgrade commands

Error Absorption Standard

Errors returned to agents are explicitly classified:

  • [INPUT_FIXABLE]: Parameter errors (e.g., misspelled site_id, unknown dimension). Fix arguments and retry.
  • [ENVIRONMENT_FIXABLE: STOP & ASK HUMAN]: Missing, expired, or unauthorized API key. Prompt user with guided setup steps.
  • [TRANSIENT]: Upstream rate limits (HTTP 429) or network hiccups. Wait briefly and retry.

MCP Client Setup

Claude Desktop (claude_desktop_config.json)
{
  "mcpServers": {
    "plausible": {
      "command": "uvx",
      "args": ["plausible-mcp"],
      "env": {
        "PLAUSIBLE_API_KEY": "YOUR_PLAUSIBLE_API_KEY"
      }
    }
  }
}

Or using the npm bridge:

{
  "mcpServers": {
    "plausible": {
      "command": "npx",
      "args": ["-y", "plausible-analytics-mcp"],
      "env": {
        "PLAUSIBLE_API_KEY": "YOUR_PLAUSIBLE_API_KEY"
      }
    }
  }
}

License

MIT License. See LICENSE for details.

Frequently asked questions

What is Plausible Analytics MCP?

Plausible Analytics MCP: privacy-first website stats, real-time visitors, breakdowns, and trends.

How do I install Plausible Analytics MCP?

It runs on your machine. In Claude Code: claude mcp add plausible-analytics-mcp -e 'PLAUSIBLE_API_KEY=<PLAUSIBLE_API_KEY>' -e 'PLAUSIBLE_SITE_ID=<PLAUSIBLE_SITE_ID>' -e 'PLAUSIBLE_BASE_URL=<PLAUSIBLE_BASE_URL>' -- uvx plausible-mcp==0.1.3. For other clients, paste the JSON configuration from this page into their MCP settings.

Does Plausible Analytics MCP need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is Plausible Analytics MCP open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains Plausible Analytics MCP?

It is published by surendranb. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.