Connects to the Google Calendar API to fetch calendar events for a given date, enabling real-time access to calendar data through natural language commands.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP Google Calendar Integrationshow my calendar events for tomorrow"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
π 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 transportgoogleapisβ Google Calendar API clientzodβ Input validationdotenvβ Load.envfiles
π Getting Started
1. Clone the repository
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