Troubleshooting

Having issues with Chimr? This guide will help you resolve common problems.

Prerequisites

Before troubleshooting specific issues, verify these basic requirements:

System Requirements
- macOS 14.0 (Sonoma) or later
Required Permissions
- Calendar Access: System Settings → Privacy & Security → Calendar → Chimr ✓
- Notifications: System Settings → Notifications → Chimr → Allow Notifications ✓
Calendar App Configuration
- Open Calendar.app → View menu
- Enable “Show All-Day Events” ✓
- Enable “Show Declined Events” ✓

If you don’t see any calendars in Chimr:

If your events aren’t updating:

Check Calendar Sync
- Open Calendar.app
- Pull to refresh or Cmd+R
- Verify events appear there first
Account Configuration
- Calendar.app → Settings → Accounts
- Ensure accounts are properly configured
- Check “Enable this account” is on
Restart Required
- Chimr currently requires restart after adding new calendars
- Quit and relaunch the app

If you’re not receiving notifications:

Verify Prerequisites - Ensure notification permission is granted (see above)
Check Chimr Settings
- Settings → Notifications tab
- Verify notification timing (1, 3, 5, 10, or 15 minutes)
- Ensure calendars are selected for notifications
System Settings
- Disable Do Not Disturb/Focus mode
- Check notification schedule settings

If notifications appear at unexpected times:

Time Zone Issues
- Verify system time zone is correct
- Check Calendar.app event time zones
- Ensure events have proper time zone info
All-Day Events
- Settings → Notifications
- Check “Notify for all-day events” setting
- Confirm your notification timing (all-day events are measured from the start of the day)

If you’re having trouble with MCP integration:

Enable Background Service - Open Chimr → Settings → Advanced and turn on “Enable Background Service”. The --mcp command is only a lightweight forwarder; the Background Service daemon is what reads your calendar. If it is off, requests fail with “Chimr’s Background Service isn’t running.” If the daemon is waiting for approval, allow Chimr in System Settings → General → Login Items & Extensions.
Verify Configuration - Ensure the path /Applications/Chimr.app/Contents/MacOS/Chimr is correct in your Claude Desktop or Claude Code settings
Check Args - Confirm ["--mcp"] is set in the args array
Restart Claude - After configuration changes, restart Claude Desktop or Claude Code
Calendar Permissions - Ensure Chimr has calendar access in System Settings → Privacy & Security → Calendars
Review Logs - Check Claude Desktop logs for specific error messages

For detailed MCP setup instructions, see MCP Integration guide.

If Chimr is consuming too many resources:

Reduce Calendar Count
- Settings → Calendars
- Disable unnecessary calendars
- Limit notification calendars
Understand Sync Behavior
- Chimr checks for notifications every 30 seconds and refreshes events every 5 minutes
- These intervals are fixed and cannot be adjusted
Restart the App
- Quit Chimr
- Launch it again to clear temporary state

This means Chimr doesn’t have permission to access your calendars. See Prerequisites section above for granting calendar access.

This typically indicates a sync issue:

Chimr needs permission to show notifications. See Prerequisites section above for granting notification access.

For advanced troubleshooting, you can inspect Chimr’s system logs:

If you continue experiencing issues: