home / mcp / google workspace mcp server

Google Workspace MCP Server

A Model Context Protocol server for Google Workspace integration (Gmail and Calendar)

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "epaproditus-google-workspace-mcp-server": {
      "command": "node",
      "args": [
        "/path/to/google-workspace-server/build/index.js"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "your_client_id",
        "GOOGLE_CLIENT_SECRET": "your_client_secret",
        "GOOGLE_REFRESH_TOKEN": "your_refresh_token"
      }
    }
  }
}

You can run a Google Workspace MCP Server to interact with Gmail and Google Calendar through a unified MCP interface. It lets you list, search, send, and organize emails and calendar events programmatically, empowering automation and integration with your tools.

How to use

To use this MCP server, connect your MCP client to the stdio server configuration described in the setup. You will run the server locally and communicate with it using MCP requests that map to Gmail and Calendar actions. You can perform bulk actions like listing recent emails, searching by Gmail query syntax, sending messages with CC/BCC, and manipulating labels. For calendars, you can list upcoming events, create events with attendees, update event details, and delete events. Configure the client to pass the appropriate parameters for each operation and handle responses or errors in your application.

Gmail Tools

Available Gmail operations include listing emails, searching with Gmail query syntax, sending new messages with optional CC and BCC, and modifying email labels such as archiving or marking as unread.

Calendar Tools

Calendar tools cover listing events within a date range, creating events with attendee lists, updating existing events, and deleting events.

Available tools

list_emails

List recent emails from your inbox with optional filtering to limit results.

search_emails

Execute advanced email searches using Gmail query syntax to filter results.

send_email

Send new emails with support for CC and BCC recipients.

modify_email

Modify email labels to archive, trash, or mark as read/unread.

list_events

List upcoming calendar events within a specified date range.

create_event

Create new calendar events and invite attendees.

update_event

Update details of existing calendar events.

delete_event

Delete calendar events from the calendar.