Frequently Asked Questions (FAQ)

Q: What is an MCP Server?

A: MCP (Model Context Protocol) is an open protocol that standardizes how applications provide context to Large Language Models (LLMs). An MCP server acts as a bridge, allowing AI models to access and interact with external data sources and tools.

Q: How does the MCP iCal Server differ from traditional calendar integrations?

A: Unlike traditional integrations that expose multiple tools, the MCP iCal Server uses an agent-based approach with a single tool interface. This simplifies client integration and allows for stateful conversations with the AI agent.

Q: What is UBOS?

A: UBOS is a full-stack AI Agent Development Platform focused on bringing AI Agents to every business department. Our platform helps you orchestrate AI Agents, connect them with your enterprise data, build custom AI Agents with your LLM model, and create Multi-Agent Systems.

Q: Can I use the MCP iCal Server with any MCP-compatible client?

A: Yes, the MCP iCal Server can be used with any MCP-compatible client. However, the provided documentation focuses on setting up the server with Claude for Desktop.

Q: What are the prerequisites for using the MCP iCal Server?

A: The prerequisites include macOS with the Calendar app configured, an MCP client (Claude for desktop recommended), an OpenAI API key, and the uv package manager.

Q: How do I configure Claude for Desktop to use the MCP iCal Server?

A: You need to create or edit the ~/Library/Application Support/Claude/claude_desktop_config.json file and include your OpenAI API key as an environment variable, along with the command and arguments to run the MCP iCal Server.

Q: Why do I need to launch Claude from the terminal?

A: Claude must be launched from the terminal to properly request calendar permissions from macOS. Launching directly from Finder will not trigger the permissions prompt.

Q: Can I use this server to create events in my Google Calendar?

A: Yes, if you have your Google Calendar synced with your iCloud Calendar, you can specify the Google Calendar when creating or updating events using the MCP iCal Server.

Q: What are the known issues with the MCP iCal Server?

A: One known issue is that non-standard recurring schedules may not always be set correctly, and reminder timing for recurring all-day events may be off by one day. Using more powerful LLM models can improve results.

Q: How can I contribute to the MCP iCal Server project?

A: You can contribute by forking the repository, creating a feature branch, committing your changes, pushing to the branch, and opening a pull request.