MCP connector

Maru in your agent.

Connect Claude, ChatGPT, Cursor or any MCP client to your Maru account. Ask about your projects, pull up the right guide and start new plug-ins from the agent you already use.

Connect an agent

One URL, your account.

Add this server to your agent. It opens Maru in your browser to sign in and approve; you never paste a password or key.

url
https://maruaudio.com/mcp

In Claude Code, Cursor, VS Code, Codex or Gemini CLI, one command adds it to the agents in your project. Add --global for every project.

terminalsh
npx maruaudio mcp install
  1. In Claude (web or desktop), open Settings → Connectors and choose Add custom connector.
  2. Name it Maru and paste https://maruaudio.com/mcp as the URL.
  3. Choose Connect, sign in to Maru if asked, and approve the access on the Maru page.
  4. In a chat, enable Maru from the tools menu and ask about your projects.

Codex, other clients, personal tokens, testing and troubleshooting: the setup guide. Every tool: the tools reference.

What your agent can do.

Guides on demand

The SDK, CLI, module-authoring and Studio guides, read by the agent when it needs them instead of answering from memory.

Your projects

Ask what you are working on. The agent lists your Studio projects, searches and reads their source to explain or review it, and links each one in Studio.

Learn from the community

Search the modules other creators published and read their open source, so the agent shows how a real instrument does it.

Start something new

Pick a template and create a Studio project or a MIDI sound bank without leaving the conversation.

Building locally? Add the skill.

The connector works with your account. For source edits, builds and the live module preview, give your coding agent the Maru agent skill and the local server. The skill teaches the agent to work through the maru CLI; the local server runs the same operations on your checkout, next to maru dev, whose browser tabs show playback, diagnostics and checks while your agent works. The second command adds the connector and the local server together.

terminalsh
npx maruaudio skill install
npx maruaudio mcp install --both

See Use Maru from your agent and the agent skill in the docs.

You stay in control.

  • You approve each agent on a Maru page that names it and where it returns. It can ask for:
    • Read Maru guides, templates, and your Studio projects and their source from your AI agent
    • Create Studio projects and sound banks in your account from your AI agent
    • Generate audio and drum kits using your credits, and cancel your generations without a new charge, asked for separately the first time it generates
  • It reads your projects’ source but cannot change it, publish, read your email or reach any other part of your account.
  • Disconnect any time in Settings → Access tokens. An agent without browser sign-in can use a personal token with the MCP permissions as a Bearer header.