mcp-server

# 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 1. Clone the repository: ```bash git clone https://github.com/yourusername/google-calendar-mcp.git cd google-calendar-mcp ``` 2. Install dependencies: ```bash npm install ``` 3. Create a `.env` file: ```bash cp .env.example .env ``` 4. 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 5. Build the project: ```bash npm run build ``` 6. Start the server: ```bash 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.