How to add Dash MCP Server to Windsurf

Search and load Dash documentation docsets and code snippets from MCP clients on macOS. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 14, 2026 · 159★ · stdio · no auth · official

Windsurf config for Dash MCP Server

claude mcp add dash-api -- uvx --from "git+https://github.com/Kapeli/dash-mcp-server.git" "dash-mcp-server"

{
  "mcpServers": {
    "dash-mcp-server": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/Kapeli/dash-mcp-server.git",
        "dash-mcp-server"
      ]
    }
  }
}

Requires `uv` (the Python package runner). Install it from https://docs.astral.sh/uv/ if `uvx` is not found.

Setup steps

1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
2Paste the Dash MCP Server config below.
3Fill in placeholder secrets, then save.
4Click Refresh in the MCP panel.
5Dash MCP Server's tools become available to Cascade.

Before you start

macOS (required for Dash app)
Dash 8 installed (https://blog.kapeli.com/dash-8)
Python 3.11.4 or higher
uv (install with: brew install uv)

What Dash MCP Server can do in Windsurf

list_installed_docsets

Lists all installed documentation sets in Dash.

search_documentation

Searches across docsets and snippets.

load_documentation_page

Loads a documentation page from a load_url returned by search_documentation.

enable_docset_fts

Enables full-text search for a specific docset.

Dash MCP Server + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the Dash MCP Server config there under the "mcpServers" key and restart the client.

What do I need to run this server?

macOS with the Dash 8 app installed, Python 3.11.4 or higher, and uv. Dash 8 can be downloaded from https://blog.kapeli.com/dash-8.

How do I add it to Claude Code?

Run: claude mcp add dash-api -- uvx --from "git+https://github.com/Kapeli/dash-mcp-server.git" "dash-mcp-server"

Is it published to PyPI or npm?

No. The server is installed directly from the GitHub repository via uvx using the git+https source URL shown in the configuration.

View repo Full Dash MCP Server page