plausible-mcp

Overview

This MCP server bridges the gap between Plausible Analytics and natural language queries, allowing users to ask questions about website traffic, visitors, and engagement metrics. It provides tools to retrieve site data, breakdown metrics by various dimensions, and filter results based on different criteria. The implementation uses TypeScript with Zod for type safety and offers secure API key handling including integration with 1Password.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• list_sites

  Get a list of all your Plausible sites

  Try:List all my Plausible sitesTry:What sites do I have in Plausible?
• get_breakdown

  Retrieve analytics data from your Plausible sites with customizable metrics, dimensions, filters, and date ranges

  Try:What were my most visited pages last week?Try:Where's my traffic coming from?Try:Show me visitor trends by country

Comparable tools

Installation

# Clone the repository
git clone https://github.com/The-Focus-AI/plausible-mcp.git
cd plausible-mcp

# Install dependencies
pnpm install

# Build the server
pnpm build

# Run the server
pnpm start

{
  "mcpServers": {
    "plausible": {
      "command": "node",
      "args": ["path/to/plausible-mcp/dist/index.js"],
      "env": {
        "PLAUSIBLE_API_KEY": "your_api_key_here",
        "PLAUSIBLE_API_URL": "https://plausible.io/api/v2"
      }
    }
  }
}

FAQ

What analytics metrics can I query with this MCP server?

You can query various metrics including visitors, pageviews, bounce rate, visit duration, and views per visit. These can be broken down by dimensions like pages, traffic sources, countries, devices, and time periods.

How is the Plausible API key handled securely?

The API key can be configured either through a .env file or using 1Password integration. The project doesn't store or transmit credentials insecurely.

Compare plausible-mcp with