Google Docs Mcp Server

gigabrainobserver/google-docs-mcp-server

4authSTDIOregistry active

Summary

Connects to Google Docs via service account with domain-wide delegation, which means no OAuth consent screens in Workspace environments. Exposes ten tools including list_tabs, read_document (with markdown conversion), append_text, insert_text, replace_text, and batch_update for formatting and complex operations. The main reason this exists is proper tab support. Google added tabs to Docs in late 2024, but most integrations either ignore them or don't set includeTabsContent=True, so they only see the first tab. This one handles nested tabs correctly and lets you target operations by tab ID or title. Requires Python 3.11+ and a service account with Docs and Drive API access.

CodeRabbit

AI writes the code. CodeRabbit catches the slop.

Try For Free →

Keep your Mac awake

Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.

One time payment $9 →

Context.dev

Integrate web data into your AI product. One API to scrape website & brand data.

Get API Key Now →

Make your agent a DeFi expert

Agent, run crypto. Access onchain data & trade routes via 1inch.

Install now →

Make money from your Skills

On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.

Start earning →

AppSignal

Monitor with ease. Code with confidence.

Start Free Trial →

CodeRabbit

AI writes the code. CodeRabbit catches the slop.

Try For Free →

Keep your Mac awake

Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.

One time payment $9 →

Context.dev

Integrate web data into your AI product. One API to scrape website & brand data.

Get API Key Now →

Make your agent a DeFi expert

Agent, run crypto. Access onchain data & trade routes via 1inch.

Install now →

Make money from your Skills

On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.

Start earning →

AppSignal

Monitor with ease. Code with confidence.

Start Free Trial →

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

Tool	Description
`list_tabs`	List all tabs (including nested) in a document
`read_document`	Read one tab or all tabs as markdown with proper heading levels
`get_document_info`	Lightweight metadata: title, ID, link, tab list
`create_document`	Create a new doc with optional initial text
`append_text`	Append text to the end of a specific tab
`insert_text`	Insert text at a character index in a tab
`replace_text`	Find and replace within a tab (or whole doc)
`batch_update`	Full batchUpdate access — formatting, tables, images, styles
`list_documents`	Search 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

Go to Google Cloud Console and create (or select) a project
Enable the Google Docs API and Google Drive API
Create a service account under IAM & Admin > Service Accounts
Create a JSON key and download it

2. Enable domain-wide delegation

In GCP, on the service account details page, enable Domain-wide Delegation and note the Client ID
In Google Workspace Admin > Security > API Controls > Domain-wide Delegation

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

Variable	Required	Description
`SERVICE_ACCOUNT_PATH`	Yes	Path to the service account JSON key file
`SUBJECT_EMAIL`	Yes	Email of the Workspace user to impersonate

License

MIT

Featured

CodeRabbit

AI writes the code. CodeRabbit catches the slop.

Try For Free →

Keep your Mac awake

Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.

One time payment $9 →

Context.dev

Integrate web data into your AI product. One API to scrape website & brand data.

Get API Key Now →

Make your agent a DeFi expert

Agent, run crypto. Access onchain data & trade routes via 1inch.

Install now →

Make money from your Skills

On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.

Start earning →

AppSignal

Monitor with ease. Code with confidence.

Start Free Trial →

Configuration

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

Categories

Documents & Knowledge

Registryactive

Packagegoogle-docs-mcp-server

TransportSTDIO

AuthRequired

UpdatedFeb 21, 2026

View on GitHub

What it does

Tool

Description

list_tabs

List all tabs (including nested) in a document

read_document

Read one tab or all tabs as markdown with proper heading levels

get_document_info

Lightweight metadata: title, ID, link, tab list

create_document

Create a new doc with optional initial text

append_text

Append text to the end of a specific tab

insert_text

Insert text at a character index in a tab

replace_text

Find and replace within a tab (or whole doc)

batch_update

Full batchUpdate access — formatting, tables, images, styles

list_documents

Search 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.

Setup

1. Create a GCP service account

Go to Google Cloud Console and create (or select) a project

Enable the Google Docs API and Google Drive API

Create a service account under IAM & Admin > Service Accounts

Create a JSON key and download it

2. Enable domain-wide delegation

In GCP, on the service account details page, enable Domain-wide Delegation and note the Client ID

In Google Workspace Admin > Security > API Controls > Domain-wide Delegation

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.

Variable

Required

Description

SERVICE_ACCOUNT_PATH

Yes

Path to the service account JSON key file

SUBJECT_EMAIL

Yes

Email of the Workspace user to impersonate

Google Docs Mcp Server

Google Docs MCP Server

What it does

Why this exists

Install

Prerequisites

Setup

1. Create a GCP service account

2. Enable domain-wide delegation

3. Configure your MCP client

Environment variables

License

Configuration

Google Docs Mcp Server

Google Docs MCP Server

What it does

Why this exists

Install

Prerequisites

Setup

1. Create a GCP service account

2. Enable domain-wide delegation

3. Configure your MCP client

Environment variables

License

Configuration

Related Documents & Knowledge MCP Servers

Related Documents & Knowledge MCP Servers