Skip to main content

Troubleshooting

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

Prerequisites​

Before troubleshooting specific issues, verify these basic requirements:

  1. System Requirements

    • macOS 14.0 (Sonoma) or later
    • TestFlight app installed (for beta)

  2. Required Permissions

    • Calendar Access: System Settings → Privacy & Security → Calendar → Chimr ✓
    • Notifications: System Settings → Notifications → Chimr → Allow Notifications ✓

  3. Calendar App Configuration

    • Open Calendar.app → View menu
    • Enable "Show All-Day Events" ✓
    • Enable "Show Declined Events" ✓

Common Issues​

Calendar Issues​

No Calendars Appearing​

If you don't see any calendars in Chimr:

  1. Verify Prerequisites - Check the permissions and settings listed above
  2. Check Calendar Accounts - Ensure accounts are configured in Calendar.app
  3. Restart Chimr - Right-click menu bar icon → Quit → Launch again

Events Not Syncing​

If your events aren't updating:

  1. Check Calendar Sync

    • Open Calendar.app
    • Pull to refresh or Cmd+R
    • Verify events appear there first

  2. Account Configuration

    • Calendar.app → Settings → Accounts
    • Ensure accounts are properly configured
    • Check "Enable this account" is on

  3. Restart Required

    • Chimr currently requires restart after adding new calendars
    • Quit and relaunch the app

Notification Issues​

Notifications Not Appearing​

If you're not receiving notifications:

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

Wrong Notification Timing​

If notifications appear at unexpected times:

  1. Time Zone Issues

    • Verify system time zone is correct
    • Check Calendar.app event time zones
    • Ensure events have proper time zone info

  2. All-Day Events

    • Settings → Notifications
    • Check "Notify for all-day events" setting
    • Adjust all-day event notification time

MCP Integration Issues​

MCP Server Not Starting​

If you're having trouble with MCP integration:

  1. Verify Configuration - Ensure correct path in Claude Desktop settings
  2. Check Python Setup - Confirm uv is installed and chimr.py has execute permissions
  3. Review Logs - Check Claude Desktop logs for specific error messages

For detailed MCP setup instructions, see MCP Integration guide.

Performance Issues​

High Memory/CPU Usage​

If Chimr is consuming too many resources:

  1. Reduce Calendar Count

    • Settings → Calendars
    • Disable unnecessary calendars
    • Limit notification calendars

  2. Adjust Sync Frequency

    • Currently manual (requires restart)
    • Future versions will have adjustable sync

  3. Clear Cache

    • Quit Chimr
    • Restart the app
    • This clears temporary data

Common Error Messages​

"Calendar Access Denied"​

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

"Failed to Load Events"​

This typically indicates a sync issue:

  1. Check internet connection
  2. Verify calendar accounts are online
  3. Open Calendar.app and refresh
  4. Restart Chimr

"Notification Permission Required"​

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

Debug Mode​

For advanced troubleshooting:

  1. Enable debug mode in Settings → Advanced
  2. Check logs in Console.app
  3. Share logs when reporting issues

Remember to disable debug mode after troubleshooting as it may impact performance.

Getting More Help​

If you continue experiencing issues:

  1. Enable debug mode for detailed logging (Settings → Advanced)
  2. Document the exact steps that cause the problem
  3. Note any error messages
  4. Check our FAQ for common questions
  5. Contact support through the channels listed on our Support page

Known Issues & Limitations​

Current Beta Limitations​

  • Clicks outside buttons in fullscreen notifications may not respond
  • Some video meeting URL patterns not recognized
  • Performance issues with large number of events
  • Notification sound customization not yet available (uses system sound)