Tools

Skip to content

You signed in with another tab or window. Reload
to refresh your session. You signed out in another tab or window. Reload
to refresh your session. You switched accounts on another tab or window. Reload
to refresh your session. Dismiss alert

StevenBtw / marimo-docs-mcp Public

• Notifications
  You must be signed in to change notification settings

• Fork 0

• Star 1

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

1 star
0 forks
Branches
Tags
Activity

Star

Notifications
You must be signed in to change notification settings

StevenBtw/marimo-docs-mcp

main

Branches
Tags

Go to file

Code

Folders and files

| Name | | Name | Last commit message | Last commit date |
| --- | --- | --- | --- |
| Latest commit
-------------

History
-------

3 Commits

| | |
| src | | src | | |
| .gitignore | | .gitignore | | |
| README.md | | README.md | | |
| package-lock.json | | package-lock.json | | |
| package.json | | package.json | | |
| tsconfig.json | | tsconfig.json | | |
| View all files | | |

Repository files navigation

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

About

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

Resources

Readme

Activity

Stars

1 star

Watchers

1 watching

Forks

0 forks

Report repository

Releases

No releases published

Packages 0

No packages published

Languages

• JavaScript 100.0%

You can’t perform that action at this time.