Google Docs & Gmail MCP Server

An MCP (Model Context Protocol) server that enables AI agents (e.g., Claude Desktop) to interact with Google Docs and Gmail — creating documents, appending content, replacing placeholders, and drafting emails.

---

Project Structure

MCP/
├── src/
│   ├── index.ts              # MCP server entry point (all tool handlers)
│   ├── auth.ts               # One-time OAuth 2.0 token generation script
│   ├── googleClient.ts       # Centralized authenticated Google API clients
│   └── tools/
│       ├── docsTools.ts      # Google Docs & Drive tool implementations
│       └── gmailTools.ts     # Gmail draft tool implementations
├── credentials.json          # ← You must download this from Google Cloud Console
├── token.json                # ← Generated automatically by: npm run auth
├── claude_desktop_config.json # Claude Desktop MCP server configuration
├── package.json
├── tsconfig.json
├── .env.example
└── .gitignore

---

Getting Started

Prerequisites

• Node.js v18+
• A Google account with access to Google Workspace (Docs + Gmail)

---

Step 1: Google Cloud Console Setup

1. Go to https://console.cloud.google.com/
2. Create a new project (e.g., MCP-Server)
3. Enable the following APIs:
   • Google Docs API
   • Google Drive API
   • Gmail API
4. Go to APIs & Services → Credentials
5. Click Create Credentials → OAuth 2.0 Client ID
   • Application Type: Desktop App
   • Name: MCP Server
6. Download the JSON file and rename it to credentials.json
7. Place credentials.json in the project root: C:\Users\Vaibhav Singh\Desktop\MCP\

---

Step 2: Authorize the Application (one-time)

powershell -ExecutionPolicy Bypass -Command "npm run auth"

This will:

• Print a Google authorization URL
• You open the URL, log in, and paste the authorization code back
• token.json is saved automatically

---

Step 3: Test the MCP Server

# Start the server directly
powershell -ExecutionPolicy Bypass -Command "npm run dev"

# Or launch the MCP Inspector UI for testing
powershell -ExecutionPolicy Bypass -Command "npm run inspect"

---

Step 4: Connect to Claude Desktop (Phase 5)

Copy the contents of claude_desktop_config.json into your Claude Desktop configuration file, located at:

• Windows: %APPDATA%\Claude\claude_desktop_config.json

Then restart Claude Desktop. You should see 7 tools available from this MCP server.

---

Available Tools

Tool	Description
create_document	Creates a new Google Doc and returns ID + URL
search_documents	Searches Google Drive for Docs by name
append_text	Appends text to the end of a document
insert_at_placeholder	Replaces {{placeholder}} text in a document
read_document	Returns the full text content of a document
create_gmail_draft	Creates a Gmail draft email (To, Subject, Body, CC)
list_gmail_drafts	Lists recent Gmail drafts

---

Example Prompts for Claude

"Create a new Google Doc titled 'Q3 Report' and append a summary of our meeting."

"Search for a document called 'Meeting Notes' and append today's agenda."

"Create a Gmail draft to john@example.com with subject 'Project Update' and a professional body."

"Find the document 'Email Log' and replace the placeholder {{latest_draft}} with the email I just dictated."