Skip to content

Setup

Create a Google Cloud Service Account

  1. Go to the Google Cloud Console
  2. Create a new project or select an existing one
  3. Enable the Google Slides API and Google Docs API:
  4. Go to APIs & Services > Library
  5. Search for "Google Slides API" and enable it
  6. Search for "Google Docs API" and enable it
  7. Create a service account:
  8. Go to APIs & Services > Credentials
  9. Click "Create Credentials" > "Service Account"
  10. Give it a name (e.g., "mcp-server")
  11. No special roles needed for read-only access
  12. Download the JSON credentials file:
  13. Click on the service account
  14. Go to "Keys" tab
  15. Add Key > Create new key > JSON
  16. Save the downloaded file securely

Share Documents with the Service Account

The service account email (found in the credentials JSON as client_email) needs access to documents:

  1. Open the Google Slides presentation or Google Doc
  2. Click "Share"
  3. Add the service account email (e.g., mcp-server@your-project.iam.gserviceaccount.com)
  4. Grant "Viewer" access (read-only is sufficient)

Sharing with Google Workspace

If you're using Google Workspace, you can share entire folders or drives with the service account for broader access.

Required OAuth Scopes

The server uses these read-only scopes:

  • https://www.googleapis.com/auth/presentations.readonly - Read Slides presentations
  • https://www.googleapis.com/auth/documents.readonly - Read Docs documents
  • https://www.googleapis.com/auth/drive.readonly - Access files shared with the service account

These scopes are automatically configured when using the server.