marimo-claude

MCP server that bridges Marimo notebooks and Claude — edit, inspect, and visualize notebooks collaboratively.

• Starts/stops Marimo as a managed subprocess with MCP enabled
• Bridges MCP protocols: stdio (for Claude Code/Desktop) ↔ HTTP (Marimo's MCP server)
• Inspects running notebooks: cells, variables, DataFrames, errors, database schemas
• Shows notebooks as interactive iframes in Claude Desktop via mcp-ui-server
• Reads notebook files directly (.py format)

Claude Code (stdio) ──→ marimo-claude (MCP Server) ──httpx──→ Marimo (HTTP MCP)
Claude Desktop (stdio) ─┘          │
                                   ├── mcp-ui-server → Notebook as iframe in client
                                   └── Process management (start/stop Marimo)

Requires Python 3.14+ and uv.

# Clone and install
git clone https://github.com/synapticore-io/marimo-claude.git
cd marimo-claude
uv sync

claude --plugin-dir /path/to/marimo-claude

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "marimo-claude": {
      "command": "uv",
      "args": ["--directory", "/path/to/marimo-claude", "run", "marimo-claude"]
    }
  }
}

uv run marimo-claude

| Tool | Description | |------|-------------| | start_marimo | Start Marimo editor with MCP enabled | | stop_marimo | Stop the running Marimo instance | | marimo_status | Check if Marimo is running | | show_notebook | Display notebook as interactive iframe | | list_notebooks | List active notebook sessions | | get_cells | Read cell structure and code | | get_variables | Inspect variables and DataFrames | | get_cell_data | Get runtime data (execution status, outputs) | | get_database_schema | Inspect database schemas | |