google-workspace

The google-workspace MCP server provides a seamless way to authenticate and access various Google Workspace APIs, including Gmail, Calendar, and Drive. By utilizing this server, you can integrate powerful Google services into your applications, enabling functionalities such as sending emails, managing calendar events, and accessing files stored in Google Drive, all through a unified interface.

Once connected to the google-workspace MCP server, you can interact with the Google Workspace APIs using authenticated requests. Although specific tools are not documented, you can perform commands such as sending a message via Gmail, retrieving calendar events, or listing files in Drive. For optimal results, ensure your queries are formatted according to the Google API specifications for the respective services you wish to interact with.

Prerequisites

Before you begin, ensure that you have Node.js installed on your machine. You can download it from nodejs.org.

Option A: Quick start with npx

If you prefer a quick start without manual installation, you can use the following command:

npx -y @aaronsb/google-workspace-mcp  

Option B: Global install alternative

For a global installation, you can clone the repository and install it directly:

git clone https://github.com/aaronsb/google-workspace-mcp  
cd google-workspace-mcp  
npm install  

When configuring the google-workspace MCP server, you will need to set up OAuth 2.0 credentials in the Google Cloud Console to obtain your client ID and client secret. Store these values in environment variables (GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET) to ensure secure access. Common issues include failing to authorize the application correctly due to misconfigured redirect URIs, so double-check your settings in the console.