Google Workspace MCP Server By Itc

🚀 Google Workspace MCP Server

This server provides APIs for performing various operations on Google Workspace, including email and calendar operations.

✨ Features

Email Operations

• Recent Email List

{
  "maxResults": 5,
  "query": "is:unread"
}

• Email Search

{
  "query": "from:example@gmail.com has:attachment",
  "maxResults": 10
}

• Send Email

{
  "to": "recipient@example.com",
  "subject": "Hello",
  "body": "Message content",
  "cc": "cc@example.com",
  "bcc": "bcc@example.com"
}

• Modify Email Labels

{
  "id": "message_id",
  "addLabels": ["UNREAD"],
  "removeLabels": ["INBOX"]
}

Calendar Operations

• View Schedule

{
  "maxResults": 10,
  "timeMin": "2024-01-01T00:00:00Z",
  "timeMax": "2024-12-31T23:59:59Z"
}

• Create Schedule

{
  "summary": "Team Meeting",
  "location": "Meeting Room",
  "description": "Weekly Sync",
  "start": "2024-01-24T10:00:00Z",
  "end": "2024-01-24T11:00:00Z",
  "attendees": ["colleague@example.com"]
}

• Update Schedule

{
  "eventId": "event_id",
  "summary": "Updated Meeting Title",
  "location": "Virtual Meeting Room",
  "start": "2024-01-24T11:00:00Z",
  "end": "2024-01-24T12:00:00Z"
}

• Delete Schedule

{
  "eventId": "event_id"
}

📦 Installation

Prerequisites

1. Install Node.js and npm.
2. Configure Google Workspace developer credentials.
3. Ensure that the Gmail API and Calendar API are enabled.

Setup Steps

Project Initialization

npm init -y

Install Dependencies

npm install express cors @google/googleapis

Create Configuration File

Create config.js:

const config = {
    google: {
        clientId: 'YOUR_CLIENT_ID',
        clientSecret: 'YOUR_CLIENT_SECRET',
        refreshToken: 'YOUR_REFRESH_TOKEN'
    }
};

module.exports = config;

Implement API Calls

Refer to the code example:

const {google} = require('googleapis');
const config = require('./config');

function gmailApiCall() {
    const auth = new google.auth.OAuth2(config.google.clientId, 
                                       config.google.clientSecret,
                                       config.google.refreshToken);
    // Implement specific API call logic
}

function calendarApiCall() {
    const auth = new google.auth.OAuth2(config.google.clientId,
                                       config.google.clientSecret,
                                       config.google.refreshToken);
    // Implement specific calendar API call logic
}

Project Build

npm run build

💻 Usage Examples

Run the Server

npm start

📚 Documentation

Troubleshooting

• Can't start the service? Check if the port is occupied or if there are errors in the configuration file.

• API request failed? Ensure that the credentials are valid and the network connection is normal.

• Insufficient log information? Enable detailed logging to get more debugging information.

References

• Node.js Official Documentation
• Google APIs Node.js Library
• Gmail API Documentation
• Calendar API Documentation