Frequently Asked Questions (FAQ)

Q: What is the Model Context Protocol (MCP)? A: MCP is an open protocol that standardizes how applications provide context to Large Language Models (LLMs). It enables AI models to access and interact with external data sources and tools.

Q: What does the macOS Notification MCP do? A: The macOS Notification MCP is a server that allows AI assistants to trigger native macOS notifications, sounds, and text-to-speech functionalities using the Model Context Protocol.

Q: What types of notifications can I trigger? A: You can trigger sound notifications, banner notifications (visual notifications), and speech notifications (text-to-speech).

Q: How do I install the macOS Notification MCP? A: You can install it using uvx (recommended), pip, or by cloning the source code from GitHub.

Q: How do I configure Claude Desktop to use the macOS Notification MCP? A: Add the provided configuration snippet to your Claude Desktop configuration file (~/Library/Application Support/Claude/claude_desktop_config.json) and restart Claude Desktop.

Q: What system sounds are available for sound notifications? A: Available sounds include Basso, Blow, Bottle, Frog, Funk, Glass, Hero, Morse, Ping, Pop, Purr, Sosumi, Submarine, and Tink.

Q: Can I customize the content of banner notifications? A: Yes, you can customize the title, message, and subtitle of banner notifications.

Q: Can I specify a custom voice for speech notifications? A: Yes, you can select from the available system voices. The tool also lets you list them.

Q: What is rate limiting and queuing? A: Rate limiting ensures that notifications are processed one at a time with a minimum interval to prevent overwhelming the user. Queuing handles multiple notification requests sequentially.

Q: What is FastMCP? A: FastMCP is a framework used to build the macOS Notification MCP, providing efficient and reliable AI communication.

Q: What should I do if notifications are not working? A: Ensure that notifications are allowed in System Settings → Notifications. Also, verify that you are using full paths if running the command directly (not using uvx).

Q: Is the macOS Notification MCP open source? A: Yes, it is licensed under the MIT License.

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