MindMeister MCP Server

An MCP (Model Context Protocol) server that connects Claude to the MindMeister API v2, enabling AI-powered mind map management directly from Claude Desktop or Claude Code.

What is MCP?

MCP is an open standard that lets AI assistants like Claude interact with external tools and services. This server exposes MindMeister operations as MCP tools that Claude can call during conversations.

Available Tools

Tool	Description
`mindmeister_get_user`	Get the authenticated user's profile
`mindmeister_get_map`	Get metadata for a specific map (JSON)
`mindmeister_list_maps`	List maps with pagination
`mindmeister_export_map`	Export a map as PDF, DOCX, PPTX, RTF, or image
`mindmeister_get_map_image`	Get the image/thumbnail of a map
`mindmeister_list_rights`	List sharing permissions for a map
`mindmeister_get_preferences`	Get user preferences

Prerequisites

Python 3.10+
A MindMeister account with API access
A Personal Access Token from MindMeister

Getting Your API Token

Log in to MindMeister
Go to Account → API → Personal Access Tokens
Create a new token with the scopes you need:
- mindmeister.readonly — for read-only access
- mindmeister — for full access
Copy the token

Installation

Option 1: Install from source

git clone https://github.com/conexaoarteiro/mindmeister-mcp.git
cd mindmeister-mcp
pip install -e .

Option 2: Install directly from GitHub

pip install git+https://github.com/conexaoarteiro/mindmeister-mcp.git

Option 3: Manual setup

git clone https://github.com/conexaoarteiro/mindmeister-mcp.git
cd mindmeister-mcp
pip install -r requirements.txt

Configuration

Set your MindMeister API token as an environment variable:

export MINDMEISTER_API_TOKEN="your_personal_access_token_here"

Or create a .env file based on .env.example:

cp .env.example .env
# Edit .env and add your token

Usage with Claude Desktop

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "mindmeister": {
      "command": "python",
      "args": ["-m", "mindmeister_mcp.server"],
      "env": {
        "MINDMEISTER_API_TOKEN": "your_personal_access_token_here"
      }
    }
  }
}

If you installed with pip install -e ., you can also use:

{
  "mcpServers": {
    "mindmeister": {
      "command": "mindmeister-mcp",
      "env": {
        "MINDMEISTER_API_TOKEN": "your_personal_access_token_here"
      }
    }
  }
}

Config file location

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

Usage with Claude Code

claude mcp add mindmeister -- python -m mindmeister_mcp.server

Then set the environment variable before running Claude Code:

export MINDMEISTER_API_TOKEN="your_token"
claude

Example Conversations

Once configured, you can ask Claude things like:

"Show me my MindMeister maps"
"Get the details of map 1234567890"
"Export map 1234567890 as PDF"
"Who has access to map 1234567890?"
"What are my MindMeister account details?"

Development

# Clone and install in dev mode
git clone https://github.com/conexaoarteiro/mindmeister-mcp.git
cd mindmeister-mcp
pip install -e ".[dev]"

# Run the server directly
python -m mindmeister_mcp.server

Project Structure

mindmeister-mcp/
├── README.md
├── pyproject.toml
├── requirements.txt
├── .env.example
├── .gitignore
└── src/
    └── mindmeister_mcp/
        ├── __init__.py
        ├── server.py      # FastMCP server with all tools
        ├── client.py       # Async HTTP client for MindMeister API v2
        └── models.py       # Pydantic input validation models

API Coverage

This server targets MindMeister API v2 (https://www.mindmeister.com/api/v2/). The following endpoints are covered:

GET /users/me — user profile
GET /maps/{id} — map metadata
GET /maps — list maps
GET /maps/{id} (with Accept header) — export as PDF/DOCX/PPTX/RTF/image
GET /map_images/{id} — map image
GET /maps/{id}/rights — map permissions
GET /users/me/preferences — user preferences

License

MIT

MindMeister MCP Server