barie-google-docs-mcp 0.1.2

Google Docs MCP Server for managing Google Docs via the Model Context Protocol

Barie Google Docs MCP Server

A Model Context Protocol (MCP) server for managing Google Docs - list docs, create docs, fetch document structure, rename documents, and edit content.

Installation

# Run directly from PyPI (recommended)
uvx barie-google-docs-mcp --help

# Optional: pin a version
uvx barie-google-docs-mcp==0.1.1 --help

# Or install locally
pip install -e .

Usage

uvx barie-google-docs-mcp \
  --access-token "YOUR_ACCESS_TOKEN" \
  --refresh-token "YOUR_REFRESH_TOKEN" \
  --client-id "YOUR_CLIENT_ID" \
  --client-secret "YOUR_CLIENT_SECRET" \
  --expiry "2024-12-31T23:59:59Z" \
  --scopes '["https://www.googleapis.com/auth/documents","https://www.googleapis.com/auth/drive.metadata.readonly","https://www.googleapis.com/auth/drive.file"]'

Cursor MCP Config

{
  "mcpServers": {
    "google-docs": {
      "command": "uvx",
      "args": [
        "barie-google-docs-mcp",
        "--access-token", "YOUR_ACCESS_TOKEN",
        "--refresh-token", "YOUR_REFRESH_TOKEN",
        "--client-id", "YOUR_CLIENT_ID",
        "--client-secret", "YOUR_CLIENT_SECRET"
      ]
    }
  }
}

Required Arguments

• --access-token - Google OAuth2 access token
• --refresh-token - Google OAuth2 refresh token
• --client-id - Google OAuth2 client ID
• --client-secret - Google OAuth2 client secret

Optional Arguments

• --expiry - Token expiry timestamp (ISO format)
• --scopes - OAuth2 scopes as JSON array string

Tools

Tool	Description
list-documents	List Google Docs files from Drive
get-document	Get a document structure by ID
create-document	Create a new Google Doc
update-document-title	Rename an existing Google Doc
insert-text	Insert text at a given index
replace-text	Replace all matching text in a document

Development

python server.py --help