Mind Elixir MCP server

Mind Elixir MCP Server

Let AI assistants build and edit real mind maps in Mind Elixir Desktop.

This is the stdio ↔ HTTP bridge that connects stdio-only MCP clients — Claude Desktop, Claude Code, Cursor, VS Code, Cline, Roo Code, Windsurf — to the MCP server built into the Mind Elixir Desktop app.

Requires Mind Elixir Desktop to be installed and running. This server is a local controller for the desktop app, not a standalone cloud service. The bridge forwards tool calls to http://127.0.0.1:6595/mcp and streams the results back.

• Registry name: io.github.mind-elixir/mcp
• npm package: @mind-elixir/mcp
• Setup guide:

Contents

• What you can do with it
• Requirements
• Quick start
• Client configuration
• Connecting without the bridge (HTTP)
• Tools reference
• Recommended agent workflow
• CLI reference
• How it works
• Troubleshooting
• Security and privacy
• Development

What you can do with it

Seven tools let an assistant read and mutate the mind map that is currently open in the app:

• Start a fresh map, or replace the current one with a structure the model designed.
• Inspect every topic, node ID, and parent/child relationship in the current map.
• Rename nodes, add child nodes, and get back the ID of what was just created.
• Attach summary nodes that collapse a range of siblings into one idea.
• Draw labelled arrows between any two nodes to express relationships that the tree cannot.

Typical uses: turning a conversation or a document into a structured map, breaking a project down into a work breakdown structure, summarising a meeting into themes, or having an assistant reorganise notes you already made by hand.

Requirements

Quick start

Start Mind Elixir Desktop first, then verify the bridge can reach it:

npx -y @mind-elixir/mcp@latest

A running bridge prints nothing to stdout (that channel is reserved for JSON-RPC) and stays in the foreground. Diagnostics go to stderr. Quit it with Ctrl+C.

To install the CLI globally instead:

npm install -g @mind-elixir/mcp
mind-elixir-mcp

Then configure your MCP client — see the next section.

Client configuration

Claude Desktop

Edit claudedesktopconfig.json:

• macOS: ~/Library/Application Support/Claude/claudedesktopconfig.json
• Windows: %APPDATA%\Claude\claudedesktopconfig.json

{
  "mcpServers": {
    "mind-elixir": {
      "command": "npx",
      "args": ["-y", "@mind-elixir/mcp@latest"]
    }
  }
}

Restart Claude Desktop after saving.

Claude Code

claude mcp add mind-elixir -- npx -y @mind-elixir/mcp@latest

Cursor

Create or edit ~/.cursor/mcp.json (or use Settings → Features → MCP → + Add New MCP Server):

Shortened. The full README is on GitHub.