You are deploying a dedicated MCP server that gives you programmatic access to Gmail and Google Calendar through the MCP interface. It lets you list, search, and send emails, manage labels, and create, update, or delete calendar events from your own automation or chat-assisted workflows.

How to use

You will run the MCP server locally or in your environment and connect to it through an MCP client. Use the Gmail tools to manage emails and the Calendar tools to manage events. The available actions include listing and filtering emails, searching with Gmail syntax, sending messages with CC/BCC, modifying labels, listing calendar events, creating events with attendees, updating events, and deleting events. When you invoke these tools, you interact with them by passing the required parameters (such as identifiers, filters, and event details) and receiving structured results that reflect the Gmail and Google Calendar state.

How to install

# Prerequisites
# 1) Node.js v14 or higher
node -v

# 2) Install dependencies for the MCP server
# From your project root (where the MCP server will run)
npm install

# 3) Build the MCP server
npm run build

# Clone the MCP server project
git clone https://github.com/epaproditus/google-workspace-mcp-server.git
cd google-workspace-mcp-server
npm install

{
  "web": {
    "client_id": "YOUR_CLIENT_ID",
    "client_secret": "YOUR_CLIENT_SECRET",
    "redirect_uris": ["http://localhost:4100/code"],
    "auth_uri": "https://accounts.google.com/o/oauth2/auth",
    "token_uri": "https://oauth2.googleapis.com/token"
  }
}

# Obtain a refresh token by running the helper
node get-refresh-token.js

This opens your browser to authenticate with Google and saves credentials to token.json. It will request Gmail modify, Gmail send, and Calendar scopes and then display the refresh token in the console.

{ "mcpServers": { "google-workspace": { "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" } } } }

Start the MCP server (example start after build)

npm run start

## Additional configuration and notes

Set up the MCP server in your client configuration to enable you to launch the server with the required credentials. The client will use the provided Google client credentials and the refresh token to obtain access tokens for Gmail and Calendar operations.

## Troubleshooting

If you encounter authentication issues, ensure you granted all required OAuth scopes, verify the client ID and secret, and confirm the refresh token is valid. For API errors, check quotas for Gmail and Calendar, verify that the APIs are enabled for your Google Cloud project, and double-check request parameters and time ranges.

## Available tools

### list\_emails

List recent emails from the inbox with optional filtering.

### search\_emails

Perform advanced email search using Gmail query syntax.

### send\_email

Send new emails with support for CC and BCC.

### modify\_email

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

### list\_events

List upcoming calendar events with date range filtering.

### create\_event

Create new calendar events with attendees.

### update\_event

Update existing calendar events.

### delete\_event

Delete calendar events.