SIGN UPLOG IN
X (Twitter)LinkedInGitHubDiscordYouTube

How to connect Plausible Analytics to Claude

Connect Claude Web, Desktop and Cowork to Plausible Analytics MCP. Summarize yesterday's traffic for your site, list top referrers from last week, and more using natural language, with authentication handled for you.

Get started for freeGet a demo
Plausible Analytics logoPlausible Analytics
Api Key

Plausible Analytics is a privacy-focused web analytics platform for simple website stats. Use it to track traffic without cookies, clutter, or heavy scripts.

13 Tools

Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.

This guide walks you through the easiest and most secure way to connect your Plausible Analytics account to Claude via Composio Connect, enabling it to summarize yesterday's traffic for your site, list top referrers from last week, compare pageviews across marketing campaigns, and more such actions on your behalf without compromising your account security.

Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

Also integrate Plausible Analytics with

Codex

Connecting Plausible Analytics to Claude Web, Desktop, and Cowork

Two ways to add the Composio connector. Pick whichever you prefer.

1. Add with one click

Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2.

Add to Claude

Add manually

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

Click Add custom connector and paste in the Composio MCP server URL:

bash
https://connect.composio.dev/mcp
Add custom connector dialog with Composio MCP server URL

2. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

3. Connect your Plausible Analytics account

Back in Claude, ask it to connect to Plausible Analytics or give it any Plausible Analytics-related task.

For example, ask Claude to:

  • "Summarize yesterday's traffic for your site"
  • "List top referrers from last week"
  • "Compare pageviews across marketing campaigns"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your Plausible Analytics account is ready to use.

What is the Plausible Analytics Claude Connector, and what's possible with it?

The Plausible Analytics MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Plausible Analytics account. It provides structured and secure access so your agent can perform Plausible Analytics operations on your behalf.

Troubleshooting

1. Why does Claude not use the Composio connector for Plausible Analytics?

The connector can show as connected, but Claude must use it in each Plausible Analytics conversation.

  • Click + at the lower left of the chat, or type /.
  • Hover Connectors.
  • Turn on Composio.
  • Ask Claude to connect to Plausible Analytics again.

2. Why does Claude show an MCP server error before Plausible Analytics connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for Plausible Analytics.

  • Check that the connector URL is https://connect.composio.dev/mcp.
  • Connectors run from Anthropic's cloud, so your device network is usually not the problem.
  • Add the connector again from Customize > Connectors, then ask Claude to connect Plausible Analytics.
  • If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the Plausible Analytics authorization link not work?

The Composio connector is one server. Your Plausible Analytics account connects separately when Claude asks for it.

  • If the browser does not open, or the link expires, ask Claude to retry the Plausible Analytics connection.
  • Composio creates a fresh Plausible Analytics authorization link.
  • Open that link in your browser and finish the Plausible Analytics sign-in.

4. Why do Plausible Analytics actions fail after they worked before?

The Plausible Analytics connection can expire or lose permission.

  • Ask Claude to inspect the Plausible Analytics connection.
  • If the connection is unhealthy, disconnect it when Claude prompts you.
  • Reconnect the Plausible Analytics account and retry the action.
  • If Claude shows a permission prompt, approve it before Claude changes data in Plausible Analytics.
  • If the action still fails with a permission error, check that the connected account has that permission in Plausible Analytics itself.

5. How do I switch to a different Plausible Analytics account?

Claude can manage the Plausible Analytics connection for you.

  • Ask Claude to disconnect or delete the current Plausible Analytics account.
  • Ask Claude to connect Plausible Analytics again.
  • Open the new Composio authorization link for Plausible Analytics.
  • Sign in with the other Plausible Analytics account in the browser.
  • After the account connects, ask Claude to retry the Plausible Analytics task.

6. Why is my Plausible Analytics connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your Plausible Analytics connection works in Claude Web, Desktop, and Cowork.

  • In Claude Desktop, open Customize > Connectors.
  • Next to Composio, click ⋮ and click Clear cache.
  • If Plausible Analytics tools still do not appear, click ⋮, disconnect, remove the connector, and add it again.
  • On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect Plausible Analytics.
TOOLS

Supported Tools

Every Plausible Analytics action and event your agent gets out of the box.

Check API Health

Tool to check the health status of the Plausible Analytics API.

Get Breakdown Stats

Tool to retrieve breakdown statistics for a specific property (dimension) from Plausible Analytics.

Get Plugin Capabilities

Tool to retrieve available capabilities for the Plausible Analytics Plugins API.

Get Realtime Visitors

Tool to retrieve the number of current visitors on your site in the last 5 minutes.

Get Site Details

Tool to retrieve details for a specific Plausible Analytics site.

Get Timeseries Stats

Tool to retrieve timeseries visitor data from Plausible Analytics over a specified time period.

List Custom Properties

Tool to list all custom properties configured for a site.

List Goals

Tool to list all goals configured for a site.

List Site Guests

Tool to list all guest users who have access to a site's dashboard in Plausible Analytics.

List Sites

Tool to list all sites the API key owner's Plausible account can access.

List Teams

Tool to list all teams available for the API key owner.

Query Analytics Stats

Tool to query analytics stats for a site using the Stats API v2.

Record Event

Tool to record a pageview or custom event via the Plausible Events API.

FRAMEWORKS

How to build Plausible Analytics MCP Agent with another framework

Codex logo

Codex

Use Plausible Analytics MCP with Codex

FAQ

Frequently asked questions

With a standalone Plausible Analytics MCP server, the agents and LLMs can only access a fixed set of Plausible Analytics tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Plausible Analytics and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Claude Cowork fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Plausible Analytics tools.

Yes, absolutely. You can configure which Plausible Analytics scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Plausible Analytics data and credentials are handled as safely as possible.

Start with Plausible Analytics.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Plausible Analytics tool your agent needs.Free to start.

Start building