Apple Calendar + Roo Code: Complete MCP Integration

Apple Calendar is a MCP server that An MCP server that allows you to interact with your macOS Calendar through natural language, including features such as event creation, modification, schedule listing, finding free time slots etc..

When integrated with Roo Code, you can:

• Access Apple Calendar functionality through Roo Code

This guide provides step-by-step instructions to set up Apple Calendar in Roo Code, including configuration, examples, and troubleshooting.

What You'll Achieve

After completing this setup:

• Apple Calendar will be fully integrated and operational
• You can use Apple Calendar tools directly in Roo Code
• All Apple Calendar capabilities will be available for your workflows

Prerequisites

Before starting, ensure you have:

• Roo Code installed and configured
• Compatible operating system (Windows, macOS, Linux)

Installation

Step 1: Install Apple Calendar

Configuration

Step 2: Configure Roo Code

1. Locate your configuration file:

   • Windows: %USERPROFILE%\.roo\mcp_settings.json
   • macOS: ~/.roo/mcp_settings.json
   • Linux: ~/.roo/mcp_settings.json

2. Add server configuration:

{
  "mcpServers": {
    "apple-calendar": {
      "command": "npx",
      "args": ["-y", "apple-calendar"],
      "env": {
        
      }
    }
  }
}

3. Restart Roo Code

Completely quit and restart Roo Code to load the new configuration.

Examples

Once configured, you can use Apple Calendar in Roo Code:

Testing Your Setup

1. Start a new conversation in Roo Code
2. Ask Roo Code to list available tools
3. Try using Apple Calendar functionality

Test prompts:

• "Type @ and verify Apple Calendar appears in the tools list"
• "Ask: "Use Apple Calendar to help with my task""
• "Check Roo Code output panel for server connection status"

Troubleshooting

Common Issues

MCP Server Not Connecting

Symptoms: Server not appearing in tools list, Connection timeout, MCP tools unavailable

Cause: Incorrect configuration or server not starting

Solution:

• Verify mcp_settings.json syntax is correct
• Check that Node.js and npx are installed and in PATH
• View Roo Code output panel for error messages
• Test server command manually in terminal: npx -y {server_id}
• Ensure environment variables are properly set

Permission Denied Errors

Symptoms: Cannot execute commands, File access denied, Terminal commands blocked

Cause: Roo Code requires explicit permission for file and command operations

Solution:

• Review and approve permission requests when prompted
• Check VS Code workspace trust settings
• Enable necessary permissions in Roo Code settings
• Verify file and folder permissions on your system

API Key or Model Issues

Symptoms: Authentication failed, Model not responding, No AI completions

Cause: AI model API key not configured or invalid

Solution:

• Verify API key is correctly set in Roo Code settings
• Check API key has sufficient credits/quota
• Test with a different AI model provider
• Review Roo Code output panel for API error details

Custom Mode Not Working with MCP

Symptoms: MCP tools not available in custom mode, Mode cannot access server

Cause: Custom mode configuration does not include MCP tool permissions

Solution:

• Edit custom mode configuration to include MCP tools
• Add "Use MCP" to available tools in mode definition
• Ensure mode has appropriate permissions for external tools
• Test with default mode first to verify MCP server works

Extension Conflicts

Symptoms: Roo Code not responding, VS Code performance issues, Unexpected behavior

Cause: Conflicts with other AI coding extensions

Solution:

• Disable other AI coding extensions (Cline, Continue, etc.)
• Restart VS Code after disabling conflicting extensions
• Check VS Code extension logs for conflict errors
• Use only one AI coding assistant extension at a time

Apple Calendar not appearing in Roo Code

Symptoms: Server not listed, Tools not available

Cause: Configuration or installation issue

Solution:

• Verify configuration syntax
• Check Apple Calendar installation
• Restart Roo Code
• Check logs for error messages

Next Steps

Now that Apple Calendar is integrated with Roo Code:

• Explore all Apple Calendar capabilities through Roo Code
• Check out other MCP servers that work with Roo Code
• Join the MCP community for tips and support
• Consider contributing to Apple Calendar development

Need Help?

• Search for Apple Calendar documentation
• Check the Roo Code MCP guide
• Join the MCP community discussions