Calendar MCP Server

# 1. Clone/navigate to the project
cd calendar-mcp

# 2. Install dependencies
npm install

# 3. Build the project
npm run build

# 4. Configure environment variables (see Configuration section)
cp .env.example .env
# Edit .env with your credentials

# 5. Test the server
node dist/index.js

npm install

npm run build

GOOGLE_ENABLED=true
GOOGLE_PROVIDER_ID=google-personal
GOOGLE_PROVIDER_NAME=Personal Google Calendar
GOOGLE_EMAIL=yourname@gmail.com
GOOGLE_CLIENT_ID=123456789.apps.googleusercontent.com
GOOGLE_CLIENT_SECRET=GOCSPX-xxxxxxxxxxxx
GOOGLE_REDIRECT_URI=http://localhost:3000/oauth/google/callback
GOOGLE_ACCESS_TOKEN=ya29.xxxxx
GOOGLE_REFRESH_TOKEN=1//xxxxx

MICROSOFT_ENABLED=true
MICROSOFT_PROVIDER_ID=microsoft-work
MICROSOFT_PROVIDER_NAME=Work Microsoft 365
MICROSOFT_EMAIL=yourname@company.com
MICROSOFT_CLIENT_ID=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
MICROSOFT_CLIENT_SECRET=xxxxxxxxxxxxxxxxxxxxx
MICROSOFT_TENANT_ID=common
MICROSOFT_REDIRECT_URI=http://localhost:3000/oauth/microsoft/callback
MICROSOFT_ACCESS_TOKEN=eyJ0eXAiOiJKV1QiLCJ...
MICROSOFT_REFRESH_TOKEN=0.xxxxx

EXCHANGE_ENABLED=true
EXCHANGE_PROVIDER_ID=exchange-work
EXCHANGE_PROVIDER_NAME=Work Exchange
EXCHANGE_EMAIL=yourname@company.com
EXCHANGE_EWS_URL=https://mail.company.com/EWS/Exchange.asmx
EXCHANGE_AUTH_METHOD=ntlm
EXCHANGE_USERNAME="yourname"
EXCHANGE_PASSWORD="YourP@ssword!"
EXCHANGE_DOMAIN="COMPANYDOMAIN"

# First Exchange Account
EXCHANGE_ENABLED=true
EXCHANGE_PROVIDER_ID=exchange-account1
EXCHANGE_PROVIDER_NAME=Account 1
EXCHANGE_EMAIL=user1@company.com
EXCHANGE_EWS_URL=https://mail.company.com/EWS/Exchange.asmx
EXCHANGE_AUTH_METHOD=ntlm
EXCHANGE_USERNAME="user1"
EXCHANGE_PASSWORD="password1"
EXCHANGE_DOMAIN="DOMAIN"

# Second Exchange Account
EXCHANGE_2_ENABLED=true
EXCHANGE_2_PROVIDER_ID=exchange-account2
EXCHANGE_2_PROVIDER_NAME=Account 2
EXCHANGE_2_EMAIL=user2@company.com
EXCHANGE_2_EWS_URL=https://mail.company.com/EWS/Exchange.asmx
EXCHANGE_2_AUTH_METHOD=ntlm
EXCHANGE_2_USERNAME="user2"
EXCHANGE_2_PASSWORD="password2"
EXCHANGE_2_DOMAIN="DOMAIN"

# Third Exchange Account (if needed)
EXCHANGE_3_ENABLED=true
# ... and so on

{
  "type": "stdio",
  "command": "node",
  "args": ["/full/path/to/calendar-mcp/dist/index.js"],
  "env": {
    "DEFAULT_TIMEZONE": "Your/Timezone",
    "EXCHANGE_ENABLED": "true",
    "EXCHANGE_PROVIDER_ID": "your-exchange",
    "EXCHANGE_PROVIDER_NAME": "Your Exchange",
    "EXCHANGE_EMAIL": "your@email.com",
    "EXCHANGE_EWS_URL": "https://mail.company.com/EWS/Exchange.asmx",
    "EXCHANGE_AUTH_METHOD": "ntlm",
    "EXCHANGE_USERNAME": "username",
    "EXCHANGE_PASSWORD": "password",
    "EXCHANGE_DOMAIN": "DOMAIN"
  }
}

{
  "projects": {
    "/path/to/your/project": {
      "mcpServers": {
        "calendar": {
          "type": "stdio",
          "command": "node",
          "args": ["/full/path/to/calendar-mcp/dist/index.js"],
          "env": {
            "DEFAULT_TIMEZONE": "Asia/Baku",
            "EXCHANGE_ENABLED": "true",
            "EXCHANGE_PROVIDER_ID": "exchange-work",
            "EXCHANGE_PROVIDER_NAME": "Work Calendar",
            "EXCHANGE_EMAIL": "you@company.com",
            "EXCHANGE_EWS_URL": "https://mail.company.com/EWS/Exchange.asmx",
            "EXCHANGE_AUTH_METHOD": "ntlm",
            "EXCHANGE_USERNAME": "username",
            "EXCHANGE_PASSWORD": "password",
            "EXCHANGE_DOMAIN": "DOMAIN"
          }
        }
      }
    }
  }
}

List all my calendars

Show me all my meetings for tomorrow
What events do I have this week?
Search my calendar for "standup" meetings

Get details for event ID AAMkADA3OWE...

Create a meeting called "Project Review" tomorrow at 2pm for 1 hour
Schedule a lunch event next Monday from 12-1pm at "Cafe Downtown"
Create a weekly team standup every Monday at 9am

Move my 2pm meeting to 3pm
Change the location of event AAMk... to "Room 201"

Delete my 3pm meeting
Cancel all instances of my recurring standup

When am I free tomorrow?
Find me a 1-hour free slot this week
Show my availability for the next 3 days during working hours

Do I have any conflicts tomorrow at 2pm?
Check if I can schedule a meeting on Friday from 10-11am

Accept the meeting invite for AAMk...
Decline the team lunch with message "I have a conflict"
Tentatively accept the project review

Find events that exist in both my Exchange calendars
Check for duplicates between Google and Microsoft

Copy event AAMk... from Exchange to Google Calendar

Compare my two Exchange calendars for this week
What events are only in my first calendar but not the second?

@calendar://today
Show me @calendar://summary
What's in @calendar://week

# Morning check
"What's on my calendar today?"

# Quick view
"Show me my next 5 meetings"

# Check availability
"Am I free at 3pm today?"

# Schedule meeting
"Schedule a 30-minute call with john@company.com tomorrow at 2pm"

"When am I free this week for a 1-hour meeting?"
"Find me an open slot tomorrow afternoon"
"Do I have any conflicts if I book 10-11am on Friday?"

"Move my 2pm meeting to 3pm"
"Cancel tomorrow's standup"
"Add 'Conference Room A' as the location for my next meeting"

"Compare my two Exchange calendars for this week"
"List all calendars I have access to"
"Copy the project review from my work calendar to personal"

LOG_LEVEL=debug node dist/index.js

# Set environment variables
export EXCHANGE_ENABLED=true
export EXCHANGE_EWS_URL=https://mail.company.com/EWS/Exchange.asmx
export EXCHANGE_AUTH_METHOD=ntlm
export EXCHANGE_USERNAME=youruser
export EXCHANGE_PASSWORD='yourpassword'
export EXCHANGE_DOMAIN=YOURDOMAIN

# Run test
node -e "
const { loadConfig, hasConfiguredProviders } = require('./dist/utils/config.js');
console.log('Has providers:', hasConfiguredProviders());
console.log('Config:', JSON.stringify(loadConfig(), null, 2));
"

calendar-mcp/
├── src/
│   ├── index.ts                 # MCP server entry point
│   ├── types/
│   │   └── index.ts             # TypeScript interfaces
│   ├── providers/
│   │   ├── base.ts              # Base provider interface
│   │   ├── google/
│   │   │   ├── index.ts         # Google Calendar provider
│   │   │   └── client.ts        # Google API client
│   │   ├── microsoft/
│   │   │   ├── index.ts         # Microsoft 365 provider
│   │   │   └── client.ts        # Graph API client
│   │   └── exchange/
│   │       ├── index.ts         # Exchange EWS provider
│   │       ├── client.ts        # EWS client with NTLM support
│   │       └── auth.ts          # Authentication manager
│   ├── services/
│   │   ├── calendar-service.ts  # Multi-provider orchestration
│   │   └── sync-service.ts      # Calendar sync logic
│   ├── tools/
│   │   ├── index.ts             # Tool registration
│   │   ├── list-calendars.ts
│   │   ├── list-events.ts
│   │   ├── get-event.ts
│   │   ├── create-event.ts
│   │   ├── update-event.ts
│   │   ├── delete-event.ts
│   │   ├── get-free-busy.ts
│   │   ├── check-conflicts.ts
│   │   ├── respond-to-invite.ts
│   │   ├── find-matching-events.ts
│   │   ├── copy-event.ts
│   │   └── compare-calendars.ts
│   ├── resources/
│   │   └── index.ts             # MCP resources
│   ├── prompts/
│   │   └── index.ts             # MCP prompts
│   └── utils/
│       ├── config.ts            # Configuration loader
│       ├── date.ts              # Date utilities
│       └── formatting.ts        # Output formatting
├── dist/                        # Compiled JavaScript
├── .env                         # Environment configuration
├── .env.example                 # Example configuration
├── package.json
├── tsconfig.json
└── README.md