IntelliSchedule Personal MCP Server

This is a standalone Model Context Protocol (MCP) server that exposes scheduling, calendar management, and productivity tools. It can be integrated with AI clients like Claude, ChatGPT, or any other MCP-compatible interface.

Features

• Google Calendar Integration: Create and list events.

• Cal.com Scheduling: Book meetings programmatically.

• Availability Checker: Check for free slots on your calendar.

• Reminders & Notes: Manage personal tasks and notes.

• Email Notifications: Send meeting confirmations.

Related MCP server: MCP Calendar Assistant

Setup

1. Clone the repository:

   git clone <your-new-repo-url>
   cd intellischedule-mcp-server

2. Install dependencies:

   npm install

3. Configure Environment Variables: Copy .env.example to .env and fill in your credentials:

   cp .env.example .env

Obtaining Credentials

• Google Calendar:

  1. Go to the Google Cloud Console.

  2. Create a project and enable the Google Calendar API.

  3. Create an OAuth 2.0 Client ID.

  4. Use the OAuth2 Playground to get your REFRESH_TOKEN.

• Cal.com:

  1. Go to Cal.com Settings > API Keys.

  2. Create a new API key.

  3. Find your event type ID in your Event Types list.

• Email (SMTP):

  1. If using Gmail, create an App Password.

  2. Use your full email as SMTP_USER.

4. Start the Server:

   npm start

Using with Claude Desktop

Add the following to your claude_desktop_config.json:

{
  "mcpServers": {
    "intellischedule": {
      "command": "node",
      "args": ["/path/to/intellischedule-mcp-server/index.js"],
      "env": {
        "GOOGLE_CLIENT_ID": "...",
        "GOOGLE_CLIENT_SECRET": "...",
        "GOOGLE_REFRESH_TOKEN": "...",
        "CAL_API_KEY": "...",
        "CAL_EVENT_TYPE_ID": "...",
        "CAL_USERNAME": "...",
        "SMTP_USER": "...",
        "SMTP_PASS": "...",
        "USER_EMAIL": "..."
      }
    }
  }
}