Google Calendar Integration Project

This project provides integration with Google Calendar API to manage and interact with calendar events programmatically.

Prerequisites

• Python 3.8 or higher

• Google Cloud Platform account

• Google Calendar API enabled

• OAuth 2.0 credentials configured

Related MCP server: Google Calendar MCP Server

Setup Instructions

Installing via Smithery

To install Google Calendar Integration Project for Claude Desktop automatically via Smithery:

npx -y smithery install @Avik-creator/googlecalendarMCP --client claude

Manual Installation

1. Clone the Repository

   git clone https://github.com/Avik-creator/googlecalendarMCP
   cd googlecalendarMCP

2. Set Up Virtual Environment

   python -m venv venv
   source venv/bin/activate  # On Windows, use `venv\Scripts\activate`

3. Install Dependencies

   pip install -r requirements.txt

4. Google Cloud Platform Setup

   a. Go to the Google Cloud Console b. Create a new project or select an existing one c. Enable the Google Calendar API d. Create OAuth 2.0 credentials:

   • Go to APIs & Services > Credentials

   • Click "Create Credentials" > "OAuth client ID"

   • Choose "Desktop Application"

   • Download the credentials JSON file

   • Rename it to credentials.json and place it in the project root

5. Environment Variables

   Create a .env file in the project root with the following variables:

   GOOGLE_APPLICATION_CREDENTIALS=path/to/credentials.json
   CALENDAR_ID=your_calendar_id@group.calendar.google.com

Usage

1. First-time Authentication

   python auth.py

   This will open a browser window for OAuth authentication. Follow the prompts to authorize the application.

2. Running the Application

   python main.py

Features

• Create, read, update, and delete calendar events

• Set up recurring events

• Manage event attendees

• Handle event notifications and reminders

Project Structure

googlecalendarMCP/
├── auth.py              # Authentication handling
├── main.py             # Main application entry point
├── requirements.txt    # Project dependencies
├── .env               # Environment variables
├── credentials.json   # Google OAuth credentials
└── token.json        # Generated OAuth token

Dependencies

The project uses the following main dependencies:

• google-auth-oauthlib

• google-auth-httplib2

• google-api-python-client

• python-dotenv

Deployed Configuration:

{
  "mcpServers": {
    "google_calendar_mcp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp-google-calendar.avikm744.workers.dev/sse"
      ]
    }
  }
}

Security Notes

• Never commit your credentials.json, token.json, or .env file to version control

• Keep your OAuth credentials secure

• Regularly rotate your credentials and tokens

Contributing

1. Fork the repository

2. Create a feature branch

3. Commit your changes

4. Push to the branch

5. Create a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.