Skip to content

Quick Start

Running the Server

With Google Service Account

mcp-google --credentials /path/to/service-account.json

With Environment Variable

export GOOGLE_CREDENTIALS_FILE=/path/to/service-account.json
mcp-google

Finding Document IDs

Presentations

The presentation ID is in the URL:

https://docs.google.com/presentation/d/PRESENTATION_ID_HERE/edit

Documents

The document ID is in the URL:

https://docs.google.com/document/d/DOCUMENT_ID_HERE/edit

URLs Supported

Google Docs tools accept either the document ID or the full URL, including URLs with query strings and anchors: 

https://docs.google.com/document/d/DOCUMENT_ID_HERE/edit?tab=t.0#heading=h.xyz

Example Tool Calls

Once the server is running with an MCP client, you can call tools:

Get Presentation Metadata

{
  "name": "get_presentation",
  "arguments": {
    "presentation_id": "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms"
  }
}

Get Document Text

{
  "name": "get_document_text",
  "arguments": {
    "document_id": "https://docs.google.com/document/d/1abc123/edit"
  }
}

Get All Slide Content with Notes

{
  "name": "get_presentation_content",
  "arguments": {
    "presentation_id": "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms",
    "include_notes": true
  }
}

Next Steps