marimo-docs-mcp

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...

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