MCP Google Calendar Server

🚀 Google Calendar MCP Server

A server-side project for interacting with Google Calendar, supporting the creation, reading, updating, and deletion of calendar events, as well as finding free time slots. It is written in Node.js and authenticated via OAuth 2.0.

🚀 Quick Start

This is a server-side project designed to interact with Google Calendar. It enables operations such as creating, reading, updating, and deleting calendar events, along with the ability to find free time slots. The project is implemented using Node.js and utilizes OAuth 2.0 for authentication.

✨ Features

• Create Events: Add new calendar events.
• Read Events: Retrieve all events within a specified time period.
• Update Events: Modify the details of existing events.
• Delete Events: Remove specific calendar events.
• Find Free Time: Locate available time windows within a specified time frame.

📦 Installation

1. Prerequisites

• Download the project files and extract them to the target directory.
• Ensure that Node.js (version 8.0 or higher is recommended) and npm are installed.

2. Install Dependencies

Run the following command in the project's root directory:

npm install

3. Configure Environment Variables

Copy the .env.example file to .env and fill in the following information according to your actual situation:

CLIENT_ID=Your client ID
CLIENT_SECRET=Your client secret
REDIRECT_URI=Redirect URI (e.g., http://localhost:3000/oauth2callback)
REFRESH_TOKEN=Obtained refresh token

💻 Usage Examples

1. As an HTTP/SSE Server

• Start the service by running the following command in the project's root directory:

npm run start:http

• The default listening address is http://localhost:3334.

2. As a CLI Tool

• Start in console mode by running the following command:

npm run start:stdio

Basic Usage

{
  "summary": "Meeting",
  "description": "Important project discussion meeting",
  "start": {
    "dateTime": "2023-10-10T09:00:00+08:00"
  },
  "end": {
    "dateTime": "2023-10-10T11:00:00+08:00"
  }
}

Advanced Usage

Obtain a Refresh Token

Step-by-step Instructions

1. Run the following script to start the authorization process:

const { google } = require('googleapis');
const http = require('http');
const url = require('url');

// Replace with your actual information
const CLIENT_ID = 'Your client ID';
const CLIENT_SECRET = 'Your client secret';
const REDIRECT_URI = 'http://localhost:3000/oauth2callback';

const oauth2Client = new google.auth.OAuth2(
  CLIENT_ID,
  CLIENT_SECRET,
  REDIRECT_URI
);

const scopes = [
  'https://www.googleapis.com/auth/calendar',
  'https://www.googleapis.com/auth/calendar.events'
];

function getRefreshToken() {
  const server = http.createServer(async (req, res) => {
    const queryParams = url.parse(req.url, true).query;
    
    if (queryParams.code) {
      try {
        const { tokens } = await oauth2Client.getToken(queryParams.code);
        console.log('Refresh token:', tokens.refresh_token);
        res.end('Authentication successful! You can close this window.');
        server.close();
      } catch (error) {
        console.error('Failed to obtain token:', error);
        res.end('Authentication failed!');
      }
    }
  }).listen(3000, () => {
    const authUrl = oauth2Client.generateAuthUrl({
      access_type: 'offline',
      scope: scopes,
      prompt: 'consent'
    });

    console.log('Open the following link in your browser:');
    console.log(authUrl);
  });
}

getRefreshToken();

2. Access the URL output by the script in your browser and follow the prompts to complete the authorization process.
3. After authorization is complete, the console will display the new refresh token.

🔧 Technical Details

Development and Debugging

npm run dev

Troubleshooting

• Authentication Error: Check if the client ID, secret, and redirect URI are correctly configured.
• Server Startup Failure: Ensure that the port is not occupied and the permissions are set correctly.

📄 License

This project is licensed under the ISC license.