English Français العربية

io.github.gigabrain-observer/google-docs-mcp-server

السجل الرسمي الإنتاجية

Google Docs MCP server with full tab support, markdown extraction, and batch updates.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package google-docs-mcp-server
Claude Code 
claude mcp add google-docs-mcp-server -e 'SERVICE_ACCOUNT_PATH=<SERVICE_ACCOUNT_PATH>' -e 'SUBJECT_EMAIL=<SUBJECT_EMAIL>' -- uvx google-docs-mcp-server==0.1.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "google-docs-mcp-server": {
            "command": "uvx",
            "args": [
                "google-docs-mcp-server==0.1.1"
            ],
            "env": {
                "SERVICE_ACCOUNT_PATH": "<SERVICE_ACCOUNT_PATH>",
                "SUBJECT_EMAIL": "<SUBJECT_EMAIL>"
            }
        }
    }
}

متغيرات البيئة

  • SERVICE_ACCOUNT_PATH إلزامي Path to the Google service account JSON key file
  • SUBJECT_EMAIL إلزامي Email of the Workspace user to impersonate via domain-wide delegation

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Google Docs MCP Server
  2. What it does
  3. Why this exists
  4. Install
  5. Prerequisites
  6. Setup
  7. Environment variables
  8. License

Google Docs MCP Server

A Model Context Protocol server for Google Docs with full tab support — something most existing servers get wrong or skip entirely.

Uses Google service accounts with domain-wide delegation, so it works in Workspace orgs without OAuth consent screens.

What it does

ToolDescription
list_tabsList all tabs (including nested) in a document
read_documentRead one tab or all tabs as markdown with proper heading levels
get_document_infoLightweight metadata: title, ID, link, tab list
create_documentCreate a new doc with optional initial text
append_textAppend text to the end of a specific tab
insert_textInsert text at a character index in a tab
replace_textFind and replace within a tab (or whole doc)
batch_updateFull batchUpdate access — formatting, tables, images, styles
list_documentsSearch Drive for docs by name

All tab-targeting tools accept tab_id or tab_title (case-insensitive). The batch_update tool auto-injects tabId into requests so you don't have to.

Why this exists

Google Docs has supported tabs since late 2024, but most MCP servers either:

  • Ignore tabs entirely (only read the first tab)
  • Don't use includeTabsContent=True, so tab content is invisible
  • Don't handle nested tabs

This server handles all of that correctly and converts content to markdown with proper heading structure.

Install

pip install google-docs-mcp-server

Or run directly with uv:

uvx google-docs-mcp-server

Prerequisites

  • Python 3.11+
  • A Google Cloud service account with domain-wide delegation

Setup

1. Create a GCP service account
  1. Go to Google Cloud Console and create (or select) a project
  2. Enable the Google Docs API and Google Drive API
  3. Create a service account under IAM & Admin > Service Accounts
  4. Create a JSON key and download it
2. Enable domain-wide delegation
  1. In GCP, on the service account details page, enable Domain-wide Delegation and note the Client ID
  2. In Google Workspace Admin > Security > API Controls > Domain-wide Delegation
  3. Add the Client ID with these scopes:
     https://www.googleapis.com/auth/documents
 https://www.googleapis.com/auth/drive.readonly
3. Configure your MCP client

Add to your MCP config (e.g. ~/.claude/mcp.json or .mcp.json):

{
  "mcpServers": {
    "google-docs": {
      "command": "uvx",
      "args": ["google-docs-mcp-server"],
      "env": {
        "SERVICE_ACCOUNT_PATH": "/path/to/your-service-account-key.json",
        "SUBJECT_EMAIL": "you@yourdomain.com"
      }
    }
  }
}

SUBJECT_EMAIL is the Workspace user the service account impersonates.

Environment variables

VariableRequiredDescription
SERVICE_ACCOUNT_PATHYesPath to the service account JSON key file
SUBJECT_EMAILYesEmail of the Workspace user to impersonate

License

MIT

الأسئلة الشائعة

ما هو io.github.gigabrain-observer/google-docs-mcp-server؟

Google Docs MCP server with full tab support, markdown extraction, and batch updates.

كيف أثبّت io.github.gigabrain-observer/google-docs-mcp-server؟

يعمل على جهازك. في Claude Code: claude mcp add google-docs-mcp-server -e 'SERVICE_ACCOUNT_PATH=<SERVICE_ACCOUNT_PATH>' -e 'SUBJECT_EMAIL=<SUBJECT_EMAIL>' -- uvx google-docs-mcp-server==0.1.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.gigabrain-observer/google-docs-mcp-server إلى مفتاح API؟

نعم. يتطلب SERVICE_ACCOUNT_PATH, SUBJECT_EMAIL، وتضبطها في إعداداته.

هل io.github.gigabrain-observer/google-docs-mcp-server مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.gigabrain-observer/google-docs-mcp-server؟

ينشره gigabrainobserver. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.