# Mind Elixir MCP server

> Lets AI assistants create, edit, and organize mind maps directly within the Mind Elixir Desktop application.

- Repository: https://github.com/mind-elixir/mcp
- Page: https://hostedmcp.org/servers/mind-elixir/mcp
- Transport: stdio
- Stars: 1
- License: MIT
- Latest version: 0.1.5

## Install

### Claude Code

```sh
claude mcp add mcp -- npx -y @mind-elixir/mcp
```

### Cursor (`~/.cursor/mcp.json`)

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

### VS Code (`.vscode/mcp.json`)

```json
{
  "servers": {
    "mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mind-elixir/mcp"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@mind-elixir/mcp"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

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

### Codex

```sh
codex mcp add mcp -- npx -y @mind-elixir/mcp
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.mcp]
command = "npx"
args = ["-y", "@mind-elixir/mcp"]
```

### Gemini CLI

```sh
gemini mcp add -s user mcp npx -- -y @mind-elixir/mcp
```

### Gemini settings.json (`~/.gemini/settings.json`)

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

## Environment variables

| Name | Required | Secret | Description |
|---|---|---|---|
| `MIND_ELIXIR_MCP_URL` | no | no | Target URL of the Mind Elixir Desktop MCP endpoint. Defaults to http://127.0.0.1:6595/mcp |

## Tools (11)

- `mindmap_data`
- `node_id`
- `topic`
- `parent_id`
- `text`
- `parent`
- `start`
- `end`
- `label`
- `from`
- `bidirectional`

## FAQ

### What are the requirements to use this server?

You must have Mind Elixir Desktop installed and running, Node.js version 18 or newer, and an MCP client that supports stdio or Streamable HTTP.

### What can the AI assistant actually do with my mind map?

The assistant can start new maps, inspect all nodes and relationships, rename nodes, add child nodes, attach summary nodes, and draw labelled arrows between nodes.