marimo-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MARIMO_TOKEN | No | Optional — only needed if marimo started with token auth |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_notebooksA | List all running marimo notebooks with their paths and ports. |
| create_notebookA | Create a new marimo notebook at the given absolute path. Args: path: Absolute path where the .py notebook file will be created. |
| get_cellsA | Get all cells with their IDs, code, and runtime state. Args: notebook: Path to the notebook file or port number (e.g. "analysis.py" or "2718"). |
| get_cell_outputsA | Get visual output and console streams for cells. Args: notebook: Path to the notebook file or port number. cell_ids: List of cell IDs to get outputs for. If empty, returns all cells. |
| get_errorsB | Get all errors in the notebook, grouped by cell. Args: notebook: Path to the notebook file or port number. |
| get_variablesB | Get all variable values and data tables in the notebook. Args: notebook: Path to the notebook file or port number. |
| get_depsA | Get the cell dependency graph showing which cells depend on which variables. Args: notebook: Path to the notebook file or port number. cell_id: Optional cell ID to get deps for a specific cell only. |
| edit_and_run_cellA | Edit a cell's code and run it. Waits for completion and returns outputs. This does NOT require --mcp flag or agent mode. Args: notebook: Path to the notebook file or port number. cell_id: The cell ID to edit (get IDs from get_cells first). code: New Python code for the cell. |
| delete_cellA | Delete a cell from a running notebook. Args: notebook: Path to the notebook file or port number. cell_id: The cell ID to delete (get IDs from get_cells first). |
| add_cellA | Add a new cell to a notebook without executing it. Args: notebook: Path to the notebook file or port number. code: Content for the new cell. after_cell_id: Insert after this cell ID. If None, appends at end. cell_type: "code" (default) or "markdown". Markdown wraps content in mo.md(...). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Vladisluv12/marimo-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server