Claude Code plugin

Anthropic's Claude Code CLI and VS Code extension support installable plugins. Breeth ships an official plugin that wires the MCP server with one command.

Install

In any Claude Code session:

/plugin marketplace add Gramies/cogram-claude-plugin
/plugin install breeth@breeth

Claude Code prompts you for a Breeth API key — paste a ck_live_… from breeth.com/app/api-keys. It's stored in the macOS Keychain / Windows Credential Manager / GNOME Keyring (whichever your OS uses), never in settings.json.

Verify with:

/breeth-help

You should see the install + auth quickstart. Then ask Claude in chat: "what Breeth tools do you have?" — five MCP tools should show.

Rotating the key

/breeth-login

This walks you through replacing the stored key (e.g. when revoking and re-minting).

How it works

Under the hood, the plugin declares:

• An mcpServers entry pointing at https://mcp.thebreeth.com/mcp via the mcp-remote shim with a --header Authorization: Bearer ${user_config.api_key} flag.
• A userConfig.api_key field marked sensitive: true, which is what triggers Claude Code to store it in the OS keychain and inject it as a CLAUDE_PLUGIN_OPTION_API_KEY env var into the MCP subprocess at launch time.

The plugin manifest is open source: github.com/Gramies/cogram-claude-plugin.

Uninstall

/plugin uninstall breeth

Removes the plugin and clears the stored API key. The key on Breeth's side is still active — revoke it from /app/api-keys if you don't want it usable anywhere else.