MCP for Claude

The Iris MCP server gives Claude Desktop direct, read-only access to your recordings as tools. Claude can answer “what did I work on yesterday?” without anyone copy-pasting JSON.

Install

Nothing to install — the server runs on demand via npx -y @iris/mcp-server. Claude Desktop launches it when configured.

Configure Claude Desktop

1. Visit Integrations in your dashboard and click Generate MCP key. Copy the key — you won’t see it again.
2. Open Claude Desktop’s config:
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
3. Add an entry under mcpServers:

{
  "mcpServers": {
    "iris": {
      "command": "npx",
      "args": ["-y", "@iris/mcp-server"],
      "env": {
        "IRIS_API_KEY": "ir_live_…",
        "IRIS_API_URL": "https://your-iris-server.example.com"
      }
    }
  }
}

Restart Claude Desktop. The Iris tools appear in the tools panel.

Tools exposed

• get_latest_recording — full context of your most recent recording.
• get_recording_context — fetch by id, optionally pulling a single field (e.g. summary, timeline).
• list_recordings — recent recordings with metadata, with optional status filter.
• get_recording_frames — frame-level OCR + descriptions + URLs + apps for a recording.
• search_recordings — full-text search across summaries, transcripts, OCR.

Other clients

Any MCP-compatible client (Cline, Continue, Cody — anything speaking the Model Context Protocol) can use the same server. Set the env vars the same way.

Found a gap or a typo? Open an issue or PR on GitHub.