🌟 Google Calendar MCP Server 🌟

Welcome to the Google Calendar MCP Server! This project aims to integrate Google Calendar with AI assistants, allowing for seamless scheduling and management of events. Whether you are a developer looking to enhance your AI assistant's capabilities or just someone interested in managing your calendar efficiently, this server provides the tools you need.

🚀 Features

• AI Assistant Integration: Connect your AI assistant with Google Calendar to manage events effortlessly.
• OAuth2 Authentication: Securely access Google Calendar with OAuth2.
• Docker Support: Easy deployment using Docker.
• Node.js Backend: Built with Node.js for fast and efficient performance.

📥 Getting Started

To get started with the Google Calendar MCP Server, you can download the latest release from the Releases section. Make sure to download the necessary files and execute them to set up your server.

Prerequisites

Before you begin, ensure you have the following installed:

• Node.js: Version 14 or higher
• Docker: Latest version
• Google Account: To access Google Calendar API

Installation

1. Clone the repository:

   git clone https://github.com/Zawad99/Google-Calendar-MCP-Server.git
   cd Google-Calendar-MCP-Server
   

2. Install dependencies:

   npm install
   

3. Set up environment variables:

   Create a .env file in the root directory and add your Google Calendar API credentials:

   GOOGLE_CLIENT_ID=your_client_id
   GOOGLE_CLIENT_SECRET=your_client_secret
   REDIRECT_URI=http://localhost:3000/auth/google/callback
   

4. Run the server:

   You can run the server using:

   npm start
   

   Alternatively, if you prefer using Docker, you can build and run the Docker container:

   docker build -t google-calendar-mcp-server .
   docker run -p 3000:3000 google-calendar-mcp-server
   

📅 Usage

Once the server is running, you can access it at http://localhost:3000. Follow these steps to connect your Google Calendar:

1. Navigate to the authentication page.
2. Authorize the application to access your Google Calendar.
3. Start managing your events through your AI assistant!

🛠️ Topics

This repository covers a variety of topics relevant to developers and users interested in AI and calendar integration:

• Agent: Build intelligent agents that can manage tasks.
• AI Assistant: Enhance your assistant's capabilities with calendar integration.
• Calendar: Manage your events efficiently.
• Docker: Simplify deployment with Docker containers.
• Google Calendar: Utilize Google Calendar's API for event management.
• Integration: Seamlessly connect different services.
• MCP Server: A Model-View-Controller server for managing requests.
• Node.js: A JavaScript runtime for building server-side applications.
• OAuth2: Securely authenticate users and access their data.

🌐 API Documentation

Endpoints

Here are some key API endpoints you can use:

• GET /events: Retrieve a list of events from your Google Calendar.
• POST /events: Create a new event in your Google Calendar.
• DELETE /events/:id: Delete an event by its ID.

Example Request

To create a new event, send a POST request to /events with the following JSON body:

{
  "summary": "Meeting with Team",
  "location": "Office",
  "start": {
    "dateTime": "2023-10-01T10:00:00-07:00"
  },
  "end": {
    "dateTime": "2023-10-01T11:00:00-07:00"
  }
}

🔒 Authentication

This project uses OAuth2 for authentication. Follow these steps to set it up:

1. Go to the Google Developer Console.
2. Create a new project.
3. Enable the Google Calendar API.
4. Create OAuth 2.0 credentials.
5. Add your redirect URI to the credentials.

📦 Docker

Docker simplifies the deployment of this server. Here’s how to use it:

1. Build the Docker image:

   docker build -t google-calendar-mcp-server .
   

2. Run the Docker container:

   docker run -p 3000:3000 google-calendar-mcp-server
   

🐛 Troubleshooting

If you encounter issues, check the following:

• Ensure all environment variables are set correctly.
• Verify your Google Calendar API credentials.
• Check the logs for any error messages.

📅 Contributing

We welcome contributions! If you have suggestions or improvements, please fork the repository and submit a pull request.

1. Fork the project.
2. Create your feature branch (git checkout -b feature/YourFeature).
3. Commit your changes (git commit -m 'Add some feature').
4. Push to the branch (git push origin feature/YourFeature).
5. Open a pull request.

📝 License

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

📬 Contact

For questions or suggestions, feel free to reach out:

• Email: your.email@example.com
• GitHub: Zawad99

📥 Download Latest Release

To get the latest version of the Google Calendar MCP Server, visit the Releases section. Download the necessary files and execute them to get started.

Thank you for checking out the Google Calendar MCP Server! We hope you find it useful for integrating Google Calendar with your AI assistant. Happy coding!