Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add Apple Calendar Server #614

Open
wants to merge 2 commits into
base: main
Choose a base branch
from

Conversation

Omar-V2
Copy link

@Omar-V2 Omar-V2 commented Feb 11, 2025

Description

Add a link to an MCP Apple Calendar server.

Server Details

Motivation and Context

This server allows users to interact with their Apple calendar on MacOS via natural language. It supports creating, updating and reading events across different calendars. It also supports advanced features such as creating recurring events, moving events between calendars, creating events with reminders etc.

I haven't seen similar functionality, specifically for Apple calendar, hence the creation of this server.

How Has This Been Tested?

Integration tests are provided in the server repo which test all calendar CRUD operations.
Extensive testing via manual prompt execution using Claude for desktop as an MCP client.
Extensive manual tool invocation via the MCP inspector tool.

Breaking Changes

No breaking changes expected, but user's will need to update their MCP client configuration to connect the mcp-ical (Apple Calendar) server.

Types of changes

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to change)
  • Documentation update

Checklist

  • I have read the MCP Protocol Documentation
  • My changes follows MCP security best practices
  • I have updated the server's README accordingly
  • I have tested this with an LLM client
  • My code follows the repository's style guidelines
  • New and existing tests pass locally
  • I have added appropriate error handling
  • I have documented all environment variables and configuration options

Additional context

Use of this MCP server will trigger a MacOS prompt asking user's to grant access to their calendar. This means that if Claude for Desktop is used as the MCP client, it must be launched via the terminal - this has been properly document in the server's README.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant