Google Workspace MCP Server No Calendar Deletetion

🚀 Google Workspace MCP Server

A Model Context Protocol (MCP) server that provides tools for interacting with Gmail and Calendar APIs. This server enables you to programmatically manage your emails and calendar events through the MCP interface.

🚀 Quick Start

✨ Features

A Model Context Protocol (MCP) server, offering tools to interact with Gmail and Calendar APIs. It allows you to programmatically manage your emails and calendar events via the MCP interface.

📦 Installation

1. Clone the repository:

   git clone https://github.com/your-repository.git
   cd google-workspace-mcp-server
   

2. Install dependencies:

   npm install
   

Configuration

1. Create a configuration file:
   • Create a config.json file in the project root directory.
   • Add the following content:

     {
       "google": {
         "client_id": "your_client_id",
         "client_secret": "your_client_secret",
         "refresh_token": "your_refresh_token"
       }
     }
     

2. Set environment variables:
   • Ensure that Node.js and npm are installed.
   • After installing the dependencies, run the server:

     npm start
     

💻 Usage Examples

Gmail Operations

Basic Usage

# Get emails
{
  "maxResults": 5,
  "query": "is:unread"
}

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

Advanced Usage

# Send an email
{
  "to": "recipient@example.com",
  "subject": "Subject",
  "body": "Email body",
  "cc": "cc@example.com",
  "bcc": "bcc@example.com"
}

# Modify email labels
{
  "id": "Email ID",
  "addLabels": ["UNREAD"],
  "removeLabels": ["INBOX"]
}

Calendar Operations

Basic Usage

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

Advanced Usage

# Create an event
{
  "summary": "Meeting title",
  "location": "Meeting room",
  "description": "Meeting description",
  "start": "2024-01-24T10:00:00Z",
  "end": "2024-01-24T11:00:00Z",
  "attendees": ["attendee@example.com"]
}

📚 Documentation

Important Notes

⚠️ Important Note

Ensure that all OAuth 2.0 credentials are correctly configured. Check the API quotas and limits in the Google Cloud Console.

Frequently Asked Questions

1. Authentication issues:
   • Ensure that all required OAuth scopes have been granted.
   • Verify that the client ID and secret are correct.
   • Check if the refresh token is valid.
2. API errors:
   • Check the API quotas and limits in the Google Cloud Console.
   • Ensure that the required APIs are enabled.
   • Verify that the request parameters are in the required format.

📄 License

This project is licensed under the MIT License.