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.

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": "..."
      }
    }
  }
}