Cookieless MCP Server

A Model Context Protocol server that lets any MCP client — Claude Desktop, Claude Code, Cursor, and others — query your Cookieless analytics in natural language.

Ask things like "What were my top pages last week?" and the assistant pulls the answer straight from your analytics.

It runs locally on your machine and talks directly to the Cookieless API over HTTPS. The only thing that leaves your computer is your API key — no analytics data passes through any third party.

Requirements

• An active Cookieless account and an API key (below).
• An MCP-compatible client (Claude Desktop, Claude Code, Cursor, etc.).
• Node.js 20+ — used automatically when the client launches the server via npx.

Getting an API key

Create a key in your Cookieless dashboard:

• Personal sites: cookieless.tech/settings/api-keys
• Team sites: https://cookieless.tech/teams/<your-team-id>/settings/api-keys

The key scopes everything to its owner: a personal key sees your personal sites, a team key sees the team's sites. Creating and deleting sites with a team key requires an admin role.

Installation

Claude Desktop

Add the server to claude_desktop_config.json (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "cookieless": {
      "command": "npx",
      "args": ["-y", "@cookieless-tech/mcp"],
      "env": { "COOKIELESS_API_KEY": "your-key" }
    }
  }
}

Restart Claude Desktop and the Cookieless tools will be available.

Claude Code

claude mcp add cookieless --env COOKIELESS_API_KEY=your-key -- npx -y @cookieless-tech/mcp

Other clients

Any MCP client works. Configure it to run npx -y @cookieless-tech/mcp over stdio with COOKIELESS_API_KEY set in the environment.

Configuration

| Env var | Required | Default | Description | | -------------------- | -------- | ----------------------------- | ---------------------------------------- | | COOKIELESS_API_KEY | Yes | — | Your Cookieless API key. | | COOKIELESS_API_URL | No | https://api.cookieless.tech | Advanced: override the API base URL. |

Tools

| Tool | What it does | | ------------- | ---------------------------------------------------------------------------------------------------- | | list_sites | List the sites your API key can access. | | get_stats | Query aggregated analytics — time ranges, group-bys, filters, funnels, and metrics like visitors, bounce rate, and session duration. | | create_site | Create a new site (requires an active subscription). | | delete_site | Permanently delete a site and all of its data. |

Example prompts

Once connected, try asking your assistant:

• "List my Cookieless sites."
• "What were my top 10 pages last week?"
• "How many unique visitors did my blog get this month, broken down by country?"
• "Show the bounce rate for /pricing over the past 30 days."
• "Build a funnel from /signup to /checkout for the past 7 days."

Privacy

True to Cookieless's privacy-first model, this server adds no tracking and stores nothing. It runs entirely on your machine and communicates only with the Cookieless API using your key.

License

MIT