Skip to main content

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

Project description

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" \
  --scopes '["https://www.googleapis.com/auth/drive", "https://www.googleapis.com/auth/documents"]'

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

barie_google_docs_mcp-0.1.3.tar.gz (6.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

barie_google_docs_mcp-0.1.3-py3-none-any.whl (7.4 kB view details)

Uploaded Python 3

File details

Details for the file barie_google_docs_mcp-0.1.3.tar.gz.

File metadata

  • Download URL: barie_google_docs_mcp-0.1.3.tar.gz
  • Upload date:
  • Size: 6.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.5

File hashes

Hashes for barie_google_docs_mcp-0.1.3.tar.gz
Algorithm Hash digest
SHA256 4a78c069e7b6b526f028264b835e7911227df553ab72fab0afc67098a8666663
MD5 ba07cc28bedccbfa79dad8d8652f95c6
BLAKE2b-256 8dc5e92f6b4f8e8053555df2cd1fa049a1116d154bc9bf3d3c66e0a9362a32dd

See more details on using hashes here.

File details

Details for the file barie_google_docs_mcp-0.1.3-py3-none-any.whl.

File metadata

File hashes

Hashes for barie_google_docs_mcp-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 f604fe6b5f5fafca9dffed605ee06c36dc687225da31c3b70b676e76eef07b26
MD5 54959468e10789ddf678021f35863006
BLAKE2b-256 98732318ef33cbe533681aecbd3a600861c535fdd4ea76349c1731fac8cca273

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page