mcp-gee-sweet 0.8.0

MCP server for Google Workspace — Sheets, Drive, Docs, and Calendar. 60+ tools for AI clients.

mcp-gee-sweet

Your AI Assistant's Gateway to Google Workspace!

An MCP server that gives AI clients reliable, direct access to Google Workspace — Sheets, Drive, Docs, and Calendar. 75 tools across four domains. Forked from xing5/mcp-google-sheets and expanded substantially.

Install (stable):

uvx mcp-gee-sweet

Install (bleeding edge — every code change on develop):

uvx --prerelease=allow mcp-gee-sweet

Full documentation →

---

Quick start

Option A: uv — local use and development

If you cloned the repo or just want to use the server from your machine, uv is all you need. No Docker required.

git clone https://github.com/khuisman/mcp-gee-sweet.git
cd mcp-gee-sweet
uv sync

Then point your MCP client at it using stdio transport (see MCP client config below). The client spawns the server as a subprocess on demand — each session gets its own isolated process, so restarting the server for a code change or config update doesn't affect other open sessions.

Option B: Docker — persistent shared server (SSE)

Use Docker when you want a single long-running server that multiple clients connect to over SSE — for example, Claude Desktop talking to the same instance as Claude Code.

git clone https://github.com/khuisman/mcp-gee-sweet.git
cd mcp-gee-sweet
make build   # build the container image
make start   # start the server (SSE on port 47000)
make logs    # tail logs

Point your MCP client at http://localhost:47000/sse.

Note: when using SSE, all clients share one server process. After a code change or restart (make restart), you must also restart each MCP client to reconnect.

---

Configuration

Set credentials via environment variable before starting the server. The recommended method for servers is a service account:

export SERVICE_ACCOUNT_PATH="/path/to/service_account.json"
export DRIVE_FOLDER_ID="your_drive_folder_id"

The server also supports OAuth, base64 credential injection, and Application Default Credentials. See Authentication for all options.

---

MCP client config

Claude Desktop — stdio (cloned repo):

{
  "mcpServers": {
    "mcp-gee-sweet": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/mcp-gee-sweet", "mcp-gee-sweet"],
      "env": {
        "SERVICE_ACCOUNT_PATH": "/path/to/service_account.json",
        "DRIVE_FOLDER_ID": "your_drive_folder_id"
      }
    }
  }
}

Claude Desktop — SSE (Docker):

{
  "mcpServers": {
    "mcp-gee-sweet": {
      "transport": "sse",
      "url": "http://localhost:47000/sse"
    }
  }
}

See Client Setup for more options including tool filtering.

---

Docs

• Tools — full tool reference (60 tools)
• Authentication — all four auth methods
• Configuration — env vars, caching, tool filtering
• Client Setup — MCP client config examples
• Design Principles — tool inclusion policy, composite tool decisions
• Roadmap — planned features and known gaps

---

Contributing

See CONTRIBUTING.md for setup, QA workflows, and PR guidelines. All items in docs/qa-checklist.md must be verified before any PyPI release.

License

MIT — see LICENSE.

Credits

• xing5/mcp-google-sheets — upstream this project was forked from
• FastMCP
• freema/mcp-gsheets and piotr-agier/google-drive-mcp — roadmap inspiration