MindmupGoogleDriveMcp

Compatibility:Claude Code, Cursor (HTTP transport).Not supported:Claude Desktop (stdio-only).

- Search MindMup filesacross your entire Google Drive (read-only)
- Tree navigation + section drill-downfor large mind maps — small files return full content, large files return an outline you can drill into
- Per-client cache isolationviaX-Client-Idheader, so different users/tools don't share cached content
- Hot-reload dev modeviafastmcp run --reload+ bind-mounted source
- FastMCP serverwith built-in/healthand/pingendpoints
- Docker Composefor both dev and prod

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

Suggested workflow for AI agents:list_files→read_mindmap→ ifoutline_only, eithersearch_mindmap(by keyword) orget_mindmap_section(bynode_pathfromsuggested_start_paths).

Note on scopes:The server requestsauth/drive+auth/drive.file. Despite the broad scope, withViewerfolder-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.

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

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

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

If you don't getsuccess, checkdocker logs <container>(Docker mode) or stdout (Python mode).

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

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

├── 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

A Model Context Protocol (MCP) server for integrating Google Docs with AI clients.

An MCP server for integrating with and managing Google Docs.

Interact with Google Docs and Google Drive for document creation, editing, and file management, with support for shared drives.

Integrates Google Workspace services like Calendar, Drive, and Gmail with AI assistants.

Create, read, update docs, spreadsheets, and presentations via AI. Connect your AI assistant to a full office suite.

Programmatic access to Google NotebookLM — via command-line interface (CLI) or Model Context Protocol (MCP) server.

Interact with Google Drive, Sheets, and Docs APIs.

Automated document processing and extraction

Convert files (DOCX, XLSX, PPTX, images), HTML, and Markdown to pixel-perfect PDFs — npx stdio or hosted Streamable HTTP, free API key in one click.