google-workspace-mcp

Google Workspace MCP Server for Cursor

An MCP (Model Context Protocol) server that provides Cursor with tools to interact with Google Workspace: Gmail, Calendar, Drive, Docs, Sheets, Slides, Chat, and People.

Repository: github.com/Dave-Nguyen-PM/google-workplace-mcp

Prerequisites

• Node.js >= 20
• A Google Cloud project with OAuth 2.0 credentials

GCP Setup

1. Go to Google Cloud Console
2. Create a new project (or use an existing one)
3. Enable these APIs:

• Gmail API
• Google Calendar API
• Google Drive API
• Google Docs API
• Google Sheets API
• Google Slides API
• Google Chat API
• People API

1. Go to APIs & Services > OAuth consent screen and configure it
2. Go to APIs & Services > Credentials and create an OAuth 2.0 Client ID (type: Desktop app)
3. Download the JSON file

Installation

cd /path/to/google-workplace-mcp
npm install
npm run build

Configuration

Place the downloaded OAuth credentials file in one of these locations:

• ./credentials.json in the project root
• ~/.google-workspace-mcp/credentials.json
• Set GOOGLE_CREDENTIALS_PATH environment variable

Add to your Cursor MCP settings (~/.cursor/mcp.json):

{
  "mcpServers": {
    "google-workspace": {
      "command": "node",
      "args": ["/path/to/google-workplace-mcp/dist/index.js"],
      "env": {
        "GOOGLE_CREDENTIALS_PATH": "/path/to/credentials.json"
      }
    }
  }
}

First Run

On the first request that requires Google auth, a browser window will open for OAuth consent. After authorizing, tokens are cached at ~/.google-workspace-mcp/tokens.json and auto-refreshed.

Tools (57 total)

| Domain | Tools | Access | |--------|-------|--------| | Auth | auth_clear, auth_refreshToken | - | | Time | time_getCurrentDate, time_getCurrentTime, time_getTimeZone | Read | | Drive | drive_search, drive_findFolder, drive_createFolder, drive_downloadFile, drive_moveFile, drive_trashFile, drive_renameFile, drive_getComments | Read/Write | | Docs | docs_create, docs_getText, docs_writeText, docs_replaceText, docs_formatText, docs_getSuggestions | Read/Write | | Sheets | sheets_getText, sheets_getRange, sheets_find, sheets_getMetadata | Read | | Slides | slides_getText, slides_find, slides_getMetadata, slides_getImages, slides_getSlideThumbnail | Read | | Calendar | calendar_list, calendar_createEvent, calendar_listEvents, calendar_getEvent, calendar_findFreeTime, calendar_updateEvent, calendar_respondToEvent, calendar_deleteEvent | Read/Write | | Gmail | gmail_search, gmail_get, gmail_downloadAttachment, gmail_modify, gmail_batchModify, gmail_modifyThread, gmail_send, gmail_createDraft, gmail_sendDraft, gmail_listLabels, gmail_createLabel | Read/Write | | Chat | chat_listSpaces, chat_findSpaceByName, chat_sendMessage, chat_getMessages, chat_sendDm, chat_findDmByEmail, chat_listThreads, chat_setUpSpace | Read/Write | | People | people_getUserProfile, people_getMe, people_getUserRelations | Read |

Debug Mode

Run with --debug to enable file logging to ~/.google-workspace-mcp/debug.log:

{
  "mcpServers": {
    "google-workspace": {
      "command": "node",
      "args": ["/path/to/dist/index.js", "--debug"]
    }
  }
}

Development

npm run dev    # Watch mode (rebuilds on changes)
npm run build  # Production build
npm start      # Run the server directly