English Français العربية

io.github.friendlygeorge/plausible-mcp-server

Registre officiel Archivé Marketing et ventes

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

Code source Documentation

Que pouvez-vous faire avec 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

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

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

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  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

Questions fréquentes

Qu'est-ce que io.github.friendlygeorge/plausible-mcp-server ?

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

Comment installer io.github.friendlygeorge/plausible-mcp-server ?

Il s'exécute sur votre machine. Dans Claude Code : claude mcp add plausible-mcp-server -- npx -y plausible-mcp-server@1.0.0. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.friendlygeorge/plausible-mcp-server ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

io.github.friendlygeorge/plausible-mcp-server est-il open source ?

Son code est public sur GitHub, mais le dépôt ne déclare pas de licence standard.

Qui maintient io.github.friendlygeorge/plausible-mcp-server ?

Il est publié par friendlygeorge. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.