Skip to main content
Glama

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

Related MCP server: Google MCP Server

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

  4. Go to APIs & Services > OAuth consent screen and configure it

  5. Go to APIs & Services > Credentials and create an OAuth 2.0 Client ID (type: Desktop app)

  6. 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
Install Server
A
license - permissive license
B
quality
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • F
    license
    -
    quality
    D
    maintenance
    A locally-hosted MCP server that integrates Gmail, Google Calendar, and Google Drive to provide AI-powered management of emails, events, and files. It enables tool-based interactions like sending emails, creating calendar events, and searching Drive files through clients like Cursor and Claude Desktop.
  • A
    license
    B
    quality
    A
    maintenance
    MCP server integrating multiple Google Workspace services including Gmail, Calendar, Drive, Sheets, Docs, Tasks, People, Forms, and Slides, enabling users to manage emails, events, files, documents, and more through natural language.
    15
    MIT

View all related MCP servers

Related MCP Connectors

  • Hosted Google Calendar MCP server for AI agents. No self-hosting or Google Cloud setup.

  • AI-powered medical document management for cancer patients. Google Drive, Gmail, Calendar via MCP.

  • GibsonAI MCP server: manage your databases with natural language

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Dave-Nguyen-PM/google-workplace-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server