📅 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