Skip to main content
The official Mavel plugin is the fastest way to connect Claude Code to Mavel. One install configures both Mavel MCP servers and adds report skills, so you skip the manual server configuration described in Setup.

​
Install

Requires Claude Code 1.0.33 or newer.

​
What it bundles

  • The analytics MCP server (https://mcp.mavel.ai/api/mcp): the full read and write tool surface plus the ready-made report prompts. Uses the same browser OAuth consent flow as every other client; the plugin ships no credentials or tokens.
  • The onboarding server (https://mcp.mavel.ai/api/mcp/onboard): anonymous by design, it only powers the signup wizard.
  • Skills that Claude invokes for you, or that you run as slash commands:
  • Background knowledge: Claude automatically knows the Mavel data model, plan limits, and worked recipes when you ask visibility questions, without you invoking anything.

​
First run

New to Mavel? Run /mavel:onboard. The wizard registers your team, sets up your brand, topics and prompts, and picks a plan, all in the terminal. Already a customer? Run /mcp, select the mavel server, and complete the browser consent. Then try /mavel:pulse.
On the consent page you choose whether to grant mcp:write. Read-only access is enough for reports and analyses; grant write access only if you want Claude to create or edit prompts, brands, topics, and tags on your behalf. See Authentication for the scope model.
Tool calls require a plan with API access (Growth and Enterprise). Any plan can list the available tools and prompts.

​
Managing and revoking access

The plugin appears as a connected agent in the dashboard under Settings → Connected agents, like any other MCP client. Revoke it there to disconnect immediately; reconnect any time by running /mcp and approving consent again.

​
Troubleshooting

Run /mavel:setup and let Claude diagnose the connection. The most common fixes: