plausible

This MCP server implements Plausible Analytics access via the Plausible API. It allows an AI agent to query domain analytics, retrieve daily or custom-range summaries, and generate analytics reports for a given domain hosted in Plausible. To use it in your Claude Desktop MCP Server setup, configure the local mcp server entry to point at your built server bundle and provide the Plausible API URL and API key via environment variables. Once running, you can prompt the assistant with requests like requesting a daily overview for a domain or generating a report for a specific date range.

Typical capabilities include: fetching daily analytics overviews, obtaining traffic metrics (visits, pageviews, users), filtering by domain (e.g., avimbu.com), and producing summarized reports suitable for inclusion in a narrative or data-driven response. The server acts as a bridge between your AI model and Plausible, handling API calls and returning structured results that your model can interpret.

To test locally in the Claude Desktop App, ensure the mcp-plausible-local server is configured as shown in the README, then use prompts like: “Can you provide a daily overview of my analytics for avimbu.com?” or “Generate a Plausible analytics report for the domain avimbu.com for last 7 days.”

Prerequisites:

• Node.js (and npm) installed on your development machine.
• Access to a Plausible account with an API key.
• Basic familiarity with editing your Claude Desktop MCP Server config.

Step-by-step installation:

1. Install dependencies and build (if the project uses a build step):
   • git clone <repository-url>
   • cd plausible-mcp-server
   • npm install
   • npm run build (if applicable) or ensure dist/index.js exists
2. Run the server locally during development:
   • node dist/index.js
   • Or in watch mode if supported: npm run watch
3. Configure the Claude Desktop MCP Server with the local mcp server entry: • command: node • args: ["/path/to/project/dist/index.js"] • env: { "PLAUSIBLE_API_URL": "https://plausible.io/api/v2", "PLAUSIBLE_API_KEY": "<your_api_key>" }
4. Replace /path/to/project/dist/index.js with the actual path to your built server entry point, and insert your real Plausible API key.
5. Restart Claude Desktop MCP Server and test prompts against the Plausible MCP endpoint.

Notes and tips:

• Keep your Plausible API key secure; avoid hard-coding it in source code. Use environment variables as shown in the config.
• The API URL used here is the Plausible v2 endpoint (https://plausible.io/api/v2). If Plausible updates their API or endpoints, update PLAUSIBLE_API_URL accordingly.
• If you encounter authentication errors, verify that the API key has the necessary permissions for the domains you query.
• When testing, ensure the domain you query (e.g., avimbu.com) is present and has data in Plausible.
• If building locally, make sure the dist/index.js path matches your output location after running the build script.
• This MCP server assumes Node.js runtime; if you switch to a different runtime, update the mcp_config accordingly.