📅 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

Install dependencies npm install
Create a .env file GOOGLE_API_KEY=your_google_calendar_api_key CALENDAR_ID=your_calendar_id_or_email
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