google-workspace-mcp-server-by-itc
0
This project offers Google Workspace functionalities like Calendar and Mail as a Model Context Protocol (MCP) server, enabling advanced management and operations through a server-side application.
Google Workspace MCP Server
An application that provides Google Workspace features (Calendar, Mail) as an MCP server.
Features
Gmail Functions
- List and filter recent emails.
- Advanced email search using Gmail query syntax.
- Send emails with CC and BCC support.
- Manage email labels (archive, trash, read/unread).
Calendar Functions
- List events within a specified date range.
- Create events with attendees.
- Update existing events.
- Delete events.
Requirements
- Node.js version 20 or above.
- Setup on Google Cloud Console including enabling Gmail and Google Calendar APIs, and OAuth 2.0 credentials.
Setup Instructions
- Clone the repository and install dependencies.
- Configure credentials and obtain a refresh token.
- Configure MCP settings with server details.
- Build and run the server.
NPM Scripts
| Command | Description |
|---|---|
npm run build | Create bundle and grant execution rights. |
npm run start | Build and run locally. |
npm run clean | Delete build artifacts. |
npm run deploy | Deploy files to production environment. |
npm run logs | Display real-time application logs from production. |
Troubleshooting
- Ensure necessary OAuth scopes are granted and credentials are correct.
- Check API quotas and limits on Google Cloud Console.
- Verify request parameters and format.