Marimo Documenation MCP Server

A Model Context Protocol (MCP) server that provides access to the Marimo Documentation.

This TypeScript-based MCP server lets you fetch and search through Marimo's API documentation, providing structured access to components, interfaces, and examples across all documentation sections.

Features

Tools

get_element_api

Get detailed API documentation for any Marimo UI element or component.

• Input: element (string) - Name of the element to get documentation for (e.g., "slider", "button")

• Output: Structured API documentation including:

  • Title and description

  • Parameters with types and defaults

  • Code examples

  • Usage patterns

search_api

Search across all Marimo API documentation.

• Input: query (string) - Search term to find in documentation

• Output: Array of matching documentation entries from any section

Documentation Sections

The server provides access to documentation for all Marimo components:

Inputs

• Form elements (button, checkbox, dropdown, etc.)

• Data inputs (array, dataframe, dictionary)

• File handling (file, file_browser)

• Interactive elements (slider, range_slider, tabs)

Layouts

• Structural components (accordion, sidebar, tree)

• Organization tools (callout, carousel)

• Content management (lazy, routes)

Media

• Media elements (audio, video, image)

• File handling (download, pdf)

• Text display (plain_text)

Core Features

• Markdown

• Control Flow

• Plotting

• HTML

• State Management

• And more...

Related MCP server: Reflex Docs MCP Server

Development

Install dependencies:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Installation

With Claude Desktop

Add to:

• MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "marimo-docs": {
      "command": "/path/to/marimo-docs/build/index.js"
    }
  }
}

With VSCode Cline Extension

Add to:

• MacOS: ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json

• Windows: %APPDATA%/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json

{
  "mcpServers": {
    "marimo-docs": {
      "command": "node",
      "args": ["/path/to/marimo-docs/build/index.js"]
    }
  }
}

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. For development, the server outputs detailed logs to stderr.

You can also use the MCP Inspector:

npm run inspector

The Inspector will provide a URL to access debugging tools in your browser.

Error Handling

The server provides organized error messages that:

• List all available elements grouped by section

• Provide clear feedback on invalid requests

• Include proper HTTP error codes

Implementation Details

• Uses Cheerio for HTML parsing of documentation pages

• Implements caching to reduce documentation fetch requests

• Handles proper URL construction for all documentation sections

• Supports recursive search across all documentation content