Google Calendar MCP Server

Google Calendar MCP Server

🗓️ A Model Context Protocol (MCP) server that enables seamless Google Calendar integration with MCP-compatible clients like Postman and Claude Desktop.

Repository: Google Calendar MCP Server

✨ Features

• ✅ Create calendar events with location, time zones
• 📅 View existing events and schedules
• ✏️ Update event details and timing
• 🗑️ Delete unwanted events
• 🔐 OAuth 2.0 authentication
• 🌍 Multi-timezone support

---

⚙️ Prerequisites

• Node.js v18+ (v20+ recommended)
• npm package manager
• Google Calendar API enabled in Google Cloud Console
• OAuth 2.0 access token (not client ID/secret)

---

🚀 Quick Start

1. Clone & Install

git clone https://github.com/Sarthak2845/Google-Calender-MCP-Sever.git
cd Google-Calender-MCP-Sever
npm install

2. Get OAuth 2.0 Access Token

1. Go to Google OAuth 2.0 Playground
2. Select Calendar API v3 scopes
3. Click Authorize APIs and sign in
4. Click Exchange authorization code for tokens
5. Copy the Access token (starts with ya29.)

3. Configure Environment

Create .env file: ```env

Replace with your actual OAuth 2.0 access token

ISTRUZI_API_KEY=ya29.a0AS3H6Ny... ```

4. Test the Server

node mcpServer.js

---

🔧 Client Setup

📮 Postman Desktop

1. Open Postman Desktop
2. Create new MCP request
3. Set type to STDIO
4. Command: node <path_to_your_project>/mcpServer.js
5. Connect and test calendar operations

🤖 Claude Desktop

1. Open Claude Desktop settings
2. Go to Developers → Edit Config
3. Add server configuration:

{
  "mcpServers": {
    "postman-calendar": {
      "command": "C:\\Program Files\\nodejs\\node.exe",
      "args": ["<path_to_your_project>\\mcpServer.js"]
    }
  }
}

Replace <path_to_your_project> with your actual project path, e.g.:

• Windows: "D:\\my-projects\\Google-Calender-MCP-Sever\\mcpServer.js"
• Mac/Linux: "/Users/username/Google-Calender-MCP-Sever/mcpServer.js"

1. Restart Claude Desktop
2. Verify server shows green (active) status

---

📝 Example Usage

Create Event

{
  "method": "tools/call",
  "params": {
    "name": "create_calendar_event",
    "arguments": {
      "calendarId": "your-email@gmail.com",
      "eventData": {
        "summary": "Team Meeting",
        "start": {
          "dateTime": "2025-03-15T10:30:00+05:30",
          "timeZone": "Asia/Kolkata"
        },
        "end": {
          "dateTime": "2025-03-15T12:30:00+05:30",
          "timeZone": "Asia/Kolkata"
        },
        "location": "Conference Room A"
      }
    }
  }
}

---

⚠️ Important Notes

• Access tokens expire after ~1 hour - refresh as needed
• Use proper IANA timezone names (e.g., Asia/Kolkata, not IST)
• Ensure end time is after start time to avoid errors
• Calendar ID is typically your Gmail address

---

🐛 Troubleshooting

| Error | Solution | |-------|----------| | Invalid Credentials | Get fresh OAuth 2.0 access token | | Time range is empty | Check start time < end time | | Node not found | Install Node.js from nodejs.org | | Server not connecting | Verify absolute paths in config |

---