Advertise
MCP.so
Sign In

Google Workspace MCP Server

@epaproditus

Repository

Basic information

Category

Other

License

MIT

Transports

stdio

Author

epaproditus

About Google Workspace MCP Server

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

#google-workspace#mcp#gmail#calendar#integration

Google Workspace MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "google-workspace-mcp-server": {
      "command": "node",
      "args": [
        "get-refresh-token.js"
      ]
    }
  }
}

Google Workspace MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Google Workspace MCP Server?

A Model Context Protocol (MCP) server that provides tools for interacting with Gmail and Calendar APIs. It enables managing emails and calendar events programmatically through the MCP interface.

How to use Google Workspace MCP Server?

Requires Node.js 14+, a Google Cloud project with Gmail API and Calendar API enabled, and OAuth 2.0 credentials. Clone the repository, install dependencies, create a credentials.json, run node get-refresh-token.js to get a refresh token, configure the MCP settings file with environment variables, then build and run.

Key features of Google Workspace MCP Server

  • List, search, send, and modify Gmail emails
  • List, create, update, and delete Calendar events
  • Gmail email labeling (archive, trash, mark read/unread)
  • Calendar event support for attendees and date filtering
  • OAuth 2.0 authentication with refresh token

Use cases of Google Workspace MCP Server

  • Automate email management: list unread, send, archive
  • Search emails using Gmail query syntax
  • Manage calendar events: create meetings with attendees
  • Update or delete existing calendar events programmatically

Frequently asked questions

1

What prerequisites are required?

Node.js version 14 or higher, a Google Cloud project with the Gmail API and Calendar API enabled, and OAuth 2.0 credentials (Client ID, Client Secret).

2

How do I authenticate with Google?

You must create a `credentials.json` file and run `node get-refresh-token.js`, which opens a browser for OAuth consent. The refresh token is saved to `token.json` and displayed.

3

What Google OAuth scopes are requested?

The server requests `https://www.googleapis.com/auth/gmail.modify`, `https://www.googleapis.com/auth/calendar`, and `https://www.googleapis.com/auth/gmail.send`.

4

How is the server configured in an MCP host?

Add a configuration entry to your MCP settings file with the command `node`, the path to `build/index.js`, and environment variables `GOOGLE_CLIENT_ID`, `GOOGLE_CLIENT_SECRET`, and `GOOGLE_REFRESH_TOKEN`.

5

What if I get API errors?

Check Google Cloud Console for API quotas/limits, ensure the Gmail and Calendar APIs are enabled for your project, and verify request parameters match the required format.

Comments

More Other MCP servers

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K

Hindsight

vectorize-io

Hindsight: Agent Memory That Learns

50.4K
N

Next Generation Movers: free moving quotes (remote MCP)

Next Generation Movers

Free moving quotes for AI agents from Next Generation Movers, a licensed interstate mover (USDOT 3764697). US long-distance nationwide and local DC/MD/VA. Indicative ballpark price and booking options; optional $0.01 x40

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K
Advertise