Calendar Setup - Enable Fast Queries

Calendar Setup - Enable Fast Queries

Purpose: Grant calendar access for 30x faster calendar queries (30s → <1s)

When to run:

• After initial Dex installation
• If calendar queries feel slow
• If you see "Calendar access denied" errors

Process

1. Check current permission status:

   • Run the permission checker: python3 core/mcp/scripts/check_calendar_permission.py
   • Show the user what status was returned
   • Do not promise that a Mac permission dialog will appear. When Dex runs inside VS Code or Cursor, that dialog often never shows.

2. If Already Authorized:

   • Great! Calendar queries are already optimized.
   • No action needed.

3. If NotDetermined or Denied:

   • VS Code and Cursor are first-class Calendar surfaces. Send the person to System Settings for the app Dex is running in. Do not send them to a standalone terminal as the only path. Do not tell them to wait for a popup. Do not tell them that granting Terminal, Python, or python3 is enough.
   • Show clear instructions:

     To enable fast calendar queries:
     
     1. Open System Settings (Command+Space, type "System Settings")
     2. Click "Privacy & Security" in the sidebar
     3. Click "Calendars"
     4. Find the app Dex is running in — VS Code or Cursor — and turn it on
     5. Click that app and set access to Full (not "Add Only")
     6. Quit the editor and open it again
     7. Run /calendar-setup again to verify
     

   • A Terminal grant does not transfer to the editor. Reinstalling Dex does not fix a missing editor grant.

4. If Restricted:

   • Explain: "Calendar access is blocked by system policies (parental controls or enterprise MDM)"