Documentation

Overview

Sirro is external memory for AI coding workflows. Your library lives outside any repository. Connected agents read and write assets through the Sirro MCP server.

After you create an account, you get a workspace API key and a dashboard where you can browse, edit, and manage saved assets. Save, get, and update through MCP use only your API key. Login is for the dashboard and account settings.

Requirements

• Node.js 20 or later (for the MCP server process)
• A Sirro account and workspace API key (sk_...)
• An MCP-compatible AI coding tool such as Cursor, Claude Code, or Codex

Install the MCP server

Sirro publishes an MCP package you can run with npx:

npx -y @sirro/mcp@0.1.0

You do not need to install Sirro globally. Your agent config runs this command and passes environment variables for your API key and API URL.

Environment variables

• SIRRO_API_KEY (required): your workspace API key from the Sirro dashboard.
• SIRRO_API_URL (required in production): the Sirro web app origin, for example https://sirro.com.

Keep your API key in MCP server environment only. Do not commit it to git or paste it into chat for configuration.

Cursor

Add Sirro to ~/.cursor/mcp.json or use the Connect flow in your Sirro dashboard for a one-click install link.

{ "mcpServers": { "sirro": { "command": "npx", "args": ["-y", "@sirro/mcp@0.1.0"], "env": { "SIRRO_API_KEY": "sk_...", "SIRRO_API_URL": "https://sirro.com" } } } }

Claude Code

Register Sirro with the Claude MCP CLI:

claude mcp add --scope user --env SIRRO_API_KEY=sk_... --env SIRRO_API_URL=https://sirro.com -- sirro -- npx -y @sirro/mcp@0.1.0

Codex

Add Sirro to ~/.codex/config.toml or use codex mcp add with the same command and environment variables.

MCP tools

• sirro_save

  Save code or a link to your Sirro library. Pass files with source paths for fast, complete saves (styles, animations, text). Sirro reads from disk and bundles local imports. Images are excluded.

• sirro_get

  Retrieve a saved asset by name.

• sirro_update

  Update metadata for a saved asset (name, category, tags, and more).

• sirro_open

  Open the Sirro dashboard in your browser (requires login).

Typical workflow

1. Create a Sirro account and copy your workspace API key.
2. Connect your agent using the steps above.
3. Ask your agent to save work, for example: save this navbar to Sirro as navbar.
4. Reuse it later in any project: use navbar from Sirro.

Next steps

How it works explains the full workflow. See Integrations for supported tools, or create an account to connect your first agent at https://sirro.com/signup.