mcp_mindmup2_google_drive

A Model Context Protocol (MCP) server that provides seamless integration between MindMup mind maps and Google Drive. This server enables you to search, retrieve, and parse MindMup files stored in your Google Drive directly through the MCP interface.

1 stars PythonOthers Updated Jun 2, 2026

claudeclaude-aigoogle-drivemcpmcp-servermindmupfastmcpmodel-context-protocolmind-mapmindmapquality-assurancesoftware-testingtesting-toolstest-casetestcasetestcases

Documentation

MindMup2 Google Drive MCP Server

A Model Context Protocol (MCP) server that lets AI clients (Claude Code, Cursor) **search, read, and drill into MindMup 2 `.mup` mind maps stored in Google Drive** — without dumping a 3MB JSON tree into the model. Large maps are auto-summarised into a tree outline; the AI then drills into specific sections by `node_path`.

> Compatibility: Claude Code, Cursor (HTTP transport).

> Not supported: Claude Desktop (stdio-only).

💫 Result

✨ Features

Search MindMup files across your entire Google Drive (read-only)
Tree navigation + section drill-down for large mind maps — small files return full content, large files return an outline you can drill into
Per-client cache isolation via `X-Client-Id` header, so different users/tools don't share cached content
Hot-reload dev mode via `fastmcp run --reload` + bind-mounted source
FastMCP server with built-in `/health` and `/ping` endpoints
Docker Compose for both dev and prod

🗺️ End-to-End Flow

code

1. Set up Google Cloud service account     →  download JSON key
2. Share your Drive folder with the SA     →  Viewer access
3. Base64-encode the JSON key              →  for X-Google-Credential header
4. Run the server  (Docker or Python)      →  http://127.0.0.1:9805
5. Configure your MCP client (Claude/Cursor) with the base64 credential
6. Verify  →  curl http://127.0.0.1:9805/health

🔧 Available MCP Tools

Tool	Description
`list_files`	List MindMup files from Google Drive (folders and non-`.mup` filtered by default). Returns `id`, `name`, `folder_url`, `size`, `modified_time`.
`read_mindmap`	Read a MindMup file by `file_id` or `file_name` (one required; name uses first partial match). Small files (- "IAM & Admin" → "Service Accounts" → "Create Service Account"- No project-level role needed (Drive sharing handles auth)- Open the SA → "Keys" tab → "Add Key" → JSON → download the key file.	!google_service_acc.jpg
4	Base64-encode the entire JSON key file (see Header Reference).⚠️ Add the JSON file to `.gitignore` — never commit it.
5	Share your Google Drive folder with the SA:- Copy the `client_email` value from the JSON- Right-click the folder → Share → paste the email- Grant Viewer access, uncheck "Notify people"- Sharing propagates to subfolders.	!google_drive_share_list2.jpg

> Note on scopes: The server requests `auth/drive` + `auth/drive.file`. Despite the broad scope, with `Viewer` folder-level sharing the SA can only read what you've shared. Workspace-managed accounts may block external sharing — if so, ask your admin to allow service-account sharing for your domain.

Run the Server

Docker (recommended):

bash

make run-dev-docker   # dev: hot-reload, source bind-mounted
make run-prod         # prod: no reload

Direct Python (no Docker):

bash

pip install -r requirements.txt
python3 run.py
# Optionally: MCP_TRANSPORT=streamable-http python3 run.py

Verify the Server

bash

curl http://127.0.0.1:9805/health
# => {"result":"success","time":"...","message":"MCP server is running. ..."}

If you don't get `success`, check `docker logs ` (Docker mode) or stdout (Python mode).

Run Tests

bash

pip install -r requirements.txt
pytest

MCP Client Configuration

Add to your MCP client config (`~/.claude/mcp.json` for Claude Code, or your Cursor MCP settings):

json

{
    "mcpServers": {
        "mindmup-gdrive": {
            "type": "http",
            "url": "http://127.0.0.1:9805/mcp",
            "headers": {
                "X-Google-Credential": "ewogICJ0eXBlIjogInNlcnZpY2VfYWNjb3VuXXXXXXXXXXX",
                "X-Client-Id": "shyin-claude-code"
            }
        }
    }
}

Header Reference

Header	Required	Description
`X-Google-Credential`	✅	Your service account JSON, base64-encoded. Use base64encode.org and paste the output here. ⚠️ Base64 is encoding, not encryption — the MCP client config sits in plaintext on disk, so don't sync it to public repos / unencrypted cloud backups.
`X-Client-Id`	Optional	A unique identifier per user + tool, e.g. `shyin-claude-code`. Used as part of the cache key `(X-Client-Id, credential_hash, file_id)` to isolate cached content across clients. If omitted, falls back to `default` (cache may be shared with other unset clients) and a warning is logged. Recommended format: `-`. Use a high-entropy value to avoid collisions with other users.

🩺 Troubleshooting

Symptom	Likely cause / fix
`health` returns nothing / connection refused	Server not running. Check `docker ps` or stdout. Port 9805 already in use? Edit `mcp_deployment/docker-compose-dev.yml` to remap.
`Google Drive authentication failed`	Invalid base64. Sanity check: `echo "$CRED" \	base64 -d \	jq .client_email` — should print the SA email.
`list_files` returns empty	(a) Folder shared with the wrong email — must match `client_email` in the JSON. (b) Files aren't `.mup` — call with `mindmup_only=False` to confirm visibility. (c) Workspace org policy blocks external sharing.
Docker build fails	Make sure Docker daemon is running. Re-run `make run-dev-docker`.
Changes not picking up in dev	Hot-reload only watches Python source. Restart the container after dependency or env changes.

🏗️ Project Structure

Click to expand

text

├── mcp_deployment/
│   ├── docker-compose-dev.yml
│   ├── docker-compose-prod.yml
│   └── Dockerfile
├── src/
│   ├── core/
│   │   ├── gdrive_client.py    # Google Drive API client
│   │   ├── gdrive_feature.py   # Google Drive feature implementation
│   │   ├── mcp_server.py       # Main MCP server with read tools
│   │   └── mindmup_parser.py   # MindMup parsing + tree navigation
│   ├── model/
│   │   ├── common_model.py     # Common data models
│   │   ├── gdrive_model.py     # Google Drive data models
│   │   └── mindmup_model.py    # Mind map data models (with to_ai_dict)
│   └── utility/
│       ├── enum.py             # Enumerations and constants
│       └── logger.py           # Logging utilities
├── tests/                      # Unit tests
├── plans/                      # Implementation plans
├── run.py                      # Main entry point
├── requirements.txt            # Python dependencies
└── makefile                    # Build and deployment commands

Frequently asked questions

What is mcp_mindmup2_google_drive?

mcp_mindmup2_google_drive is A Model Context Protocol (MCP) server that provides seamless integration between MindMup mind maps and Google Drive. This server enables you to search, retrieve, and parse MindMup files stored in your Google Drive directly through the MCP interface.

How do I install mcp_mindmup2_google_drive?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is mcp_mindmup2_google_drive open source?

Yes — it is hosted on GitHub at https://github.com/shyinlim/mcp_mindmup2_google_drive and has 1 stars.

Related MCP tools

google_workspace_mcp

Control Gmail, Google Calendar, Docs, Sheets, Slides, Chat, Forms, Tasks, Search & Drive with AI - Comprehensive Google Workspace MCP Server & CLI Tool

3,117 Python

aigmailgoogle-calendar+17

jcodemunch-mcp

Cut AI token costs 95%+ on code exploration. The leading MCP server for precise, symbol-level GitHub code retrieval via tree-sitter AST. Works with Claude Code, Cursor & any MCP client. 313B+ tokens saved.

2,651 Python

claudeclaude-codeai-coding+17

OpenOSINT

AI-powered OSINT agent with interactive REPL, MCP server, and CLI. 19 tools. Works with Claude, GPT-4, or local models. For authorized security research only.

1,523 Python

ai-agentanthropicclaude+16

cve-mcp-server

Production-grade MCP server giving Claude 27 security intelligence tools across 21 APIs — CVE lookup, EPSS scoring, CISA KEV, MITRE ATT&CK, Shodan, VirusTotal, and more.

1,383 Python

cisa-kevclaude-aicve+15

projectmem

Open-source coding agent memory. Records issues, attempts, fixes and decisions, then warns your agent before it repeats an approach that already failed. Native MCP server for Claude Code, Cursor, Antigravity and Codex. 100% local, no cloud, no telemetry. MIT.

796 Python

ai-agentsai-memoryai-tools+17

memora

Give your AI agents persistent, collective memory — with deduplicating absorb, supersession lineage, semantic search, and a graph UI. Speaks MCP.

715 Python

ai-agentclaudeknowledge-graph+13

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP