Google Docs MCP Server

This MCP server provides tools to list Google Docs, read their content (converted to Markdown), and add comments.

Setup

1. Google Cloud Project:

   • Go to Google Cloud Console.
   • Enable Google Docs API and Google Drive API.
   • Go to APIs & Services > Credentials.
   • Create an OAuth 2.0 Client ID (Type: Desktop App).
   • Copy your Client ID and Client Secret.

2. Configuration:

   • Create a .env file from .env.example:

     cp .env.example .env
     

   • Fill in GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET.
   • Set GOOGLE_REDIRECT_URI to http://localhost:3000/oauthcallback.

3. Authorization:

   • Run the auth setup script:

     npm run auth:setup
     

   • Open the URL in your browser, authorize, and you will be redirected to a page (that might not exist).
   • Copy the code= parameter from the URL in your browser's address bar.
   • Paste it back into the terminal.
   • Copy the generated Refresh Token and paste it into your .env as GOOGLE_REFRESH_TOKEN.

Tools

• list_docs: Lists Google Docs in your Drive.
• get_doc: Fetches and parses a Google Doc to Markdown.
• add_comment: Adds a comment to a doc.

Usage (Claude Desktop)

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "google-docs": {
      "command": "node",
      "args": [
        "absolute/path/to/google-docs-mcp/node_modules/.bin/tsx",
        "absolute/path/to/google-docs-mcp/src/index.ts"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "your_client_id",
        "GOOGLE_CLIENT_SECRET": "your_client_secret",
        "GOOGLE_REDIRECT_URI": "http://localhost:3000/oauthcallback",
        "GOOGLE_REFRESH_TOKEN": "your_refresh_token"
      }
    }
  }
}