📅 MCP Google Calendar Integration

This project is a Model Context Protocol (MCP) tool that connects with the Google Calendar API to fetch calendar events for a given date. It integrates seamlessly with AI-driven editors like **Cursor** to enhance your productivity by bringing live calendar data right into your coding environment.

🔧 Features

• 📆 Get calendar events for a specific date
• ⚡ Real-time integration using MCP
• 🧠 Natural language tool commands from inside your editor
• ✅ Simple schema validation using `zod`
• 🔒 Uses environment variables to keep sensitive info secure

📁 Project Structure

/MCP_SERVER

│

├── server.js # MCP server setup and calendar tool

├── .env # Environment variables (not committed)

├── package.json # Dependencies and scripts

└── .mcp # MCP configuration file

📦 Technologies Used

• `@modelcontextprotocol/sdk` – MCP server and transport
• `googleapis` – Google Calendar API client
• `zod` – Input validation
• `dotenv` – Load `.env` files

🚀 Getting Started

1. Clone the repository

git clone https://github.com/your-username/mcp-calendar-tool.git
cd mcp-calendar-tool

2. Install dependencies

npm install

3. Create a .env file

GOOGLE_API_KEY=your_google_calendar_api_key

CALENDAR_ID=your_calendar_id_or_email

4. Run the server

npm start

Usage Example (in Cursor)

🛠 MCP Configuration (.mcp)

{

"mcpServers": {

"myCalenderData": {

"command": "node",

"args": ["server.js"],

"env": {

"GOOGLE_API_KEY": "your_api_key_here",

"CALENDAR_ID": "your_calendar_id_here"

}

}

}

}

🔐 Notes on API Access

Make sure the Google Calendar API is enabled in your Google Cloud Console.

The calendar should be public or shared properly if using an API key.

🧭 Future Improvements

Add OAuth2 authentication for multiple users

Support recurring events and event descriptions

Integrate Google Tasks and reminders

📄 License

This project is open-source and available under the MIT License.

🙋‍♂️ Author

Pranay Chowdhury

Frontend Developer | MERN Stack Enthusiast

LinkedIn • GitHub