English Français العربية

io.github.friendlygeorge/plausible-mcp-server

Official registry Archived Marketing and sales

MCP server for Plausible Analytics — privacy-friendly web analytics. 12 tools for traffic, conver...

Source code Documentation

What can you do with io.github.friendlygeorge/plausible-mcp-server?

  • 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

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).

NPM package plausible-mcp-server
Claude Code 
claude mcp add plausible-mcp-server -- npx -y plausible-mcp-server@1.0.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "plausible-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "plausible-mcp-server@1.0.0"
            ]
        }
    }
}

Documentation

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

Contents
  1. Plausible Analytics MCP Server
  2. Features
  3. 12 Tools
  4. Setup
  5. Usage Examples
  6. Environment Variables
  7. Supported Metrics
  8. Supported Dimensions
  9. License

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

12 Tools

ToolDescription
query_statsFull flexible stats query (the main endpoint)
realtime_visitorsCurrent real-time visitor count
get_breakdownBreakdown by any dimension (source, page, country, etc.)
get_timeseriesMetrics over time with configurable intervals
list_sitesList all sites in your account
get_siteGet site details
get_custom_eventsCustom event breakdown
get_entry_pagesTop landing pages
get_exit_pagesTop exit pages
get_utm_statsUTM campaign/source/medium breakdowns
get_device_statsBrowser, OS, screen size breakdowns
get_goalsConversion stats for all goals

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

VariableRequiredDefaultDescription
PLAUSIBLE_API_KEYYes—Your Plausible API key
PLAUSIBLE_API_BASENohttps://plausible.ioAPI base URL (change for self-hosted)

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

Frequently asked questions

What is io.github.friendlygeorge/plausible-mcp-server?

MCP server for Plausible Analytics — privacy-friendly web analytics. 12 tools for traffic, conver...

How do I install io.github.friendlygeorge/plausible-mcp-server?

It runs on your machine. In Claude Code: claude mcp add plausible-mcp-server -- npx -y plausible-mcp-server@1.0.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.friendlygeorge/plausible-mcp-server 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 io.github.friendlygeorge/plausible-mcp-server open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.friendlygeorge/plausible-mcp-server?

It is published by friendlygeorge. 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.