Skip to main content

MCP Server Integration

Chimr includes a built-in Model Context Protocol (MCP) server that enables AI assistants like Claude Desktop and Claude Code to interact with your calendar. This integration allows for intelligent calendar queries, automated notifications, and seamless meeting management.

What is MCP?​

The Model Context Protocol is a standard that allows AI assistants to interact with external tools and services. Chimr's MCP server acts as a bridge between Claude and your macOS calendar, running entirely locally on your machine.

Key Benefits​

  • Natural language calendar queries - "What meetings do I have tomorrow?"
  • AI-triggered notifications - Get notified when Claude finishes long-running tasks
  • Smart meeting management - Join video calls with a simple command
  • Privacy-first design - All data stays on your Mac, with granular privacy controls

Getting Started​

Configuration for Claude Desktop / Claude Code​

Add the following to your MCP configuration file:

For Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "chimr": {
      "command": "/Applications/Chimr.app/Contents/MacOS/Chimr",
      "args": ["--mcp"]
    }
  }
}

For Claude Code (~/.claude/settings.json):

{
  "mcpServers": {
    "chimr": {
      "command": "/Applications/Chimr.app/Contents/MacOS/Chimr",
      "args": ["--mcp"]
    }
  }
}

After adding the configuration, restart Claude Desktop or Claude Code to enable the integration.

No Additional Setup Required

Unlike previous versions, the new MCP implementation runs directly from the Chimr application binary. No Python, uv, or additional dependencies are needed.

Available Tools​

The MCP server provides 6 tools that Claude can use:

chimr_ping​

Health check to verify the MCP server is running.

  • Returns: "pong" with current timestamp
  • Use case: Verify Chimr MCP connectivity

chimr_get_today_events​

Get all calendar events for today.

  • Returns: Formatted list of today's events with times, titles, locations, and video links
  • Privacy-aware: Output respects your privacy level settings
  • Use case: "What's on my calendar today?"

chimr_get_events​

Get calendar events for a specific date.

  • Parameters: date (YYYY-MM-DD format)
  • Returns: Events for the specified date
  • Use case: "What meetings do I have on Friday?"

chimr_get_events_range​

Get all calendar events within a date range with analytics.

  • Parameters: start_date, end_date (YYYY-MM-DD format)
  • Returns:
    • Events grouped by date
    • Summary statistics (total events, days with events, total days span)
  • Use case: "Summarize my meetings for next week"

chimr_join_video_meeting​

Join a video meeting for a specific event.

  • Parameters: event_id (from get_today_events)
  • Supported platforms: Zoom, Google Meet, Microsoft Teams, Webex
  • Returns: Success/error message
  • Use case: "Join my next meeting"

chimr_show_notification​

Display a floating notification card in Chimr.

  • Parameters:
    • message (required): The notification content
    • sender (required): Who/what is sending the notification
    • title (optional): Notification title
    • duration (optional): Display duration in seconds (default: 30)
  • Returns: Success/error message
  • Use case: Notify when AI tasks complete

Privacy Settings​

Chimr offers comprehensive privacy controls for MCP integration, allowing you to control exactly what information is shared with AI assistants.

Privacy Levels​

Navigate to Settings → Advanced → MCP Privacy to configure your privacy preferences:

MCP Privacy Settings

  1. Strict - Maximum privacy protection

    • Only shares time slots and attendance status
    • Event titles are replaced with "[Event]"
    • No location, notes, attendees, or any personal information
    • Designed for users who need absolute privacy

  2. Minimal (Default) - Only shares basic event information

    • Event title, time, and location
    • Number of attendees (but not their names)
    • Video link indicator (but not the actual URL)
    • No personal details

  3. Standard - Balanced privacy with useful context

    • Includes participant names (but not email addresses)
    • Video conference URLs for easy meeting joins
    • Event notes and descriptions
    • Organizer information

  4. Detailed - Full information sharing

    • All available event information
    • Including email addresses
    • Complete attendee details

Custom Privacy Controls​

You can fine-tune what information is shared by toggling individual settings:

MCP Privacy Detail Settings

  • Include attendee names - Share participant names
  • Include attendee email addresses - Share email addresses (requires attendee names to be enabled)
  • Include video conference URLs - Share Zoom, Meet, Teams links
  • Include event notes/descriptions - Share event details and agenda
  • Include organizer information - Share who organized the meeting

Information Preview​

The privacy settings include a real-time preview showing exactly what information will be shared with AI assistants:

MCP Privacy Preview

This preview updates immediately as you change settings, helping you understand the impact of your privacy choices.

Privacy First

By default, Chimr uses the "Minimal" privacy level to protect your information. You can increase the sharing level based on your comfort and needs.

Data Security

Your calendar data is only accessed when you actively use calendar-related features through an MCP client. The privacy settings control exactly which information is shared.

MCP communication happens locally on your Mac via stdio. However, depending on the MCP client you use, the retrieved calendar data (filtered by your privacy settings) may be sent to external servers for AI processing.

Common Use Cases​

AI-Triggered Notifications​

One of the most powerful features is having Claude send you notifications when tasks complete:

  • "Analyze this codebase and notify me when you're done"
  • "Run the tests and send me a notification with the results"
  • "Research this topic and alert me when you have findings"
  • "Build the project and let me know if it succeeds"

This is especially useful for long-running AI tasks where you want to work on other things.

Daily Planning​

Ask Claude to help with your schedule:

  • "What does my day look like?"
  • "Do I have any conflicts today?"
  • "When is my first meeting?"
  • "Am I free this afternoon?"

Meeting Preparation​

Let Claude assist with meeting prep:

  • "Who's attending the product review?"
  • "Where is my 3 PM meeting?"
  • "Join the team standup"
  • "What's the video link for my next call?"

Calendar Analysis​

Get insights about your schedule:

  • "How many meetings do I have this week?"
  • "Which day is least busy?"
  • "Show me all video calls tomorrow"
  • "Summarize my schedule for the next 7 days"

Weekly Planning​

Analyze your week with the date range tool:

  • "Show me all events between Monday and Friday"
  • "How many hours of meetings do I have this month?"
  • "Compare this week's meeting load to last week"
  • "Find days with the most free time next week"

Troubleshooting​

MCP Server Not Connecting​

  1. Ensure Chimr is installed in /Applications/
  2. Verify the configuration path is correct
  3. Restart Claude Desktop or Claude Code after configuration changes
  4. Check that Chimr has calendar permissions in System Settings → Privacy & Security → Calendars

No Events Returned​

  1. Confirm calendar permissions are granted
  2. Check that calendars are selected in Chimr's settings
  3. Verify events exist for the requested date range

Notifications Not Appearing​

  1. Ensure Chimr app is running
  2. Check that notification permissions are enabled
  3. Verify the sender parameter is provided in show_notification calls