Google Calendar MCP Server

By pranavmanoj1 GitHub

mcp server

Overview

What is Google Calendar MCP Server?

Google Calendar MCP Server is a powerful Model Context Protocol (MCP) server that integrates with Google Calendar to provide intelligent, context-aware calendar management capabilities.

How to use Google Calendar MCP Server?

To use the MCP server, clone the repository, install dependencies, configure your Google Calendar API credentials in a .env file, build the project, and start the server. You can then interact with the server using natural language commands for various calendar operations.

Key features of Google Calendar MCP Server?

Smart calendar management with event listing, creation, updates, and deletions.
Context-aware operations that maintain context between calendar actions.
Secure authentication and token management with OAuth 2.0.
Robust error handling and validation.

Use cases of Google Calendar MCP Server?

Listing upcoming events and managing schedules.
Creating and updating events through natural language commands.
Deleting events securely and efficiently.

FAQ from Google Calendar MCP Server?

What are the prerequisites to run the server?

You need Node.js (v16 or higher), a Google Cloud Platform account, Google Calendar API enabled, and OAuth 2.0 credentials.

Is the server secure?

Yes! All credentials and tokens are stored securely, and OAuth 2.0 ensures secure access to Google Calendar.

Can I contribute to the project?

Yes! Contributions are welcome, and you can submit a Pull Request.

Content

Google Calendar MCP Server

A powerful Model Context Protocol (MCP) server that integrates with Google Calendar to provide intelligent, context-aware calendar management capabilities.

Features

Smart Calendar Management
- List and view upcoming events with detailed information
- Create new events with custom titles, locations, and attendees
- Update existing events with new information
- Delete events from your calendar
- Support for multiple calendars
Context-Aware Operations
- Maintains context between calendar operations
- Intelligent event formatting and display
- Secure authentication and token management
- Robust error handling and validation

Prerequisites

Node.js (v16 or higher)
Google Cloud Platform account
Google Calendar API enabled
OAuth 2.0 credentials from Google Cloud Console

Setup

Clone the repository:

git clone https://github.com/yourusername/google-calendar-mcp.git
cd google-calendar-mcp

Install dependencies:
```
npm install
```
Create a .env file:
```
cp .env.example .env
```
Update the .env file with your Google Calendar API credentials:
- GOOGLE_CLIENT_ID: Your Google Cloud Console client ID
- GOOGLE_CLIENT_SECRET: Your Google Cloud Console client secret
- GOOGLE_REDIRECT_URI: Your configured redirect URI
Build the project:
```
npm run build
```
Start the server:
```
npm start
```

Usage Examples

The MCP server supports various calendar operations through natural language commands:

Event Listing

"Show me my next 5 upcoming events"
"List all events for next week"
"What's on my calendar for tomorrow?"

Event Creation

"Schedule a meeting with John and Sarah tomorrow at 2pm"
"Create a lunch event with the team next Friday at 12pm"
"Add a doctor's appointment for next Monday at 10am"

Event Updates

"Move my 2pm meeting to 3pm"
"Add Mike to tomorrow's team meeting"
"Update the location of Friday's meeting"

Event Deletion

"Cancel my 3pm meeting today"
"Remove the team lunch from next Friday"

Security

All credentials and tokens are stored securely and are not committed to version control
OAuth 2.0 authentication ensures secure access to Google Calendar
Environment variables are used for sensitive configuration

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

No tools information available.

No content found.