Plausible Mcp Server

io.github.friendlygeorgePublished by GitHub account friendlygeorgev1.0.0Updated Oct 28, 2026

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

VerifiedSTDIODesktop onlyData & Analytics Business & Commerce

Server details

Identifier: io.github.friendlygeorge/plausible-mcp-server
Transport: STDIO
Runtime: Desktop only
Trust: Verified
Published: Sep 16, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account friendlygeorge for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.friendlygeorge%2Fplausible-mcp-server.svg)](https://sourceweft.com/mcp/io.github.friendlygeorge%2Fplausible-mcp-server?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

MCP server for Plausible Analytics that lets an assistant query traffic, conversions, sources and device breakdowns from a Plausible account.

What you can do: Run flexible stats queries with chosen metrics, dimensions, filters and date ranges
Check real-time visitor counts and metrics over time at daily, weekly, monthly or hourly intervals
Break down traffic by source, page, country, browser, OS, screen size and UTM campaign
Review custom events, entry and exit pages, and conversion stats for configured goals
List and inspect the sites in the account
When to use it: Useful when you want an assistant to answer questions about website traffic and conversions in a Plausible account, such as top sources, visitor counts, time series or goal conversion rates, without opening the dashboard.
Requirements: Runs locally as a Node.js process (npm package plausible-mcp-server, or built from source with npm and tsc). Needs a Plausible Analytics account (cloud or self-hosted) and an API key supplied in the PLAUSIBLE_API_KEY environment variable; self-hosted instances also set PLAUSIBLE_API_BASE. Network access to the Plausible API is required.

Before you install

Requires a Plausible API key (PLAUSIBLE_API_KEY) that grants read access to your analytics account; keep it out of shared configs. The listed tools only read analytics data, but the key's scope should be checked. For self-hosted setups, PLAUSIBLE_API_BASE decides which server receives requests, so point it only at a trusted instance.

Installation

In SourceWeft

Open Plausible Mcp Server in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

Tool	Description
`query_stats`	Full flexible stats query (the main endpoint)
`realtime_visitors`	Current real-time visitor count
`get_breakdown`	Breakdown by any dimension (source, page, country, etc.)
`get_timeseries`	Metrics over time with configurable intervals
`list_sites`	List all sites in your account
`get_site`	Get site details
`get_custom_events`	Custom event breakdown
`get_entry_pages`	Top landing pages
`get_exit_pages`	Top exit pages
`get_utm_stats`	UTM campaign/source/medium breakdowns
`get_device_stats`	Browser, OS, screen size breakdowns
`get_goals`	Conversion stats for all goals

Setup

Prerequisites

A Plausible Analytics account (cloud or self-hosted)
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):

json

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

{  "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:

json

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

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

Build from source

bash

git clone https://github.com/friendlygeorge/plausible-mcp-server.gitcd plausible-mcp-servernpm installnpx tsc

git clone https://github.com/friendlygeorge/plausible-mcp-server.gitcd plausible-mcp-servernpm installnpx 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

Source: README.md at commit cd8ca3b

Tools

SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

v1.0.0LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 days25 pts
Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.
Auth declared10 pts
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
Tools listed15 pts
Answer tools/list without a credential, or ship a package that starts in a sandbox without one.
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts
Declare a license in the repository or the registry entry.

Variable	Required	Default	Description
`PLAUSIBLE_API_KEY`	Yes	—	Your Plausible API key
`PLAUSIBLE_API_BASE`	No	`https://plausible.io`	API base URL (change for self-hosted)