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

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.