What is Googlecalendarmcp

googlecalendarMCP is a project that integrates with the Google Calendar API, allowing users to manage and interact with calendar events programmatically.

Use cases

Use cases include automating the creation of calendar events for meetings, managing reminders for important dates, and integrating calendar functionalities into applications for enhanced user experience.

How to use

To use googlecalendarMCP, clone the repository, set up a virtual environment, install dependencies, configure Google Cloud Platform with OAuth 2.0 credentials, and then run the authentication and main application scripts.

Key features

Key features include creating, reading, updating, and deleting calendar events, setting up recurring events, managing event attendees, and handling event notifications and reminders.

Where to use

googlecalendarMCP can be used in various fields such as personal productivity, event management, team collaboration, and automated scheduling.

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
   [email protected]
   

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.