Permissions

Macuse requires specific macOS permissions to interact with native apps. You only need to grant permissions for the features you want to use.

Checking Permission Status

To see which permissions are needed or granted:

1. Open Macuse from your menu bar
2. Click the Tools card
3. Click the arrow next to any toolbox to expand it
4. Permission status is shown with "Granted" or "Required" badges

Permission Types

Granting Permissions

Standard Permissions

For Calendar, Reminders, and Contacts:

1. Macuse will prompt you when first accessing these features
2. Click "Allow" in the system dialog
3. The permission is granted immediately

Full Disk Access

Required for reading Mail, Notes, and Messages databases:

1. Open System Settings → Privacy & Security → Full Disk Access
2. Click + and add Macuse.app from Applications
3. Restart Macuse for changes to take effect

Automation

Required for Mail, Notes, and Messages write operations (composing emails, creating notes, sending messages):

1. Macuse will prompt you when first performing a write operation
2. Click "Allow" in the system dialog to grant access to the specific app
3. The permission is granted immediately

Alternatively, you can grant access manually:

1. Open System Settings → Privacy & Security → Automation
2. Find Macuse in the list
3. Enable access for Mail.app, Notes.app, and/or Messages.app

Accessibility

Required for UI inspection and control:

1. Open System Settings → Privacy & Security → Accessibility
2. Click + and add Macuse.app from Applications
3. No restart required

Permission States

Each permission can be in one of these states:

• Granted - Full access to the feature
• Limited - Partial access (e.g., add-only for Calendar)
• Denied - Access was explicitly denied
• Not Determined - Not yet requested

Revoking Permissions

To revoke a permission:

1. Open System Settings → Privacy & Security
2. Select the permission category
3. Uncheck or remove Macuse from the list

Troubleshooting

If a permission isn't working:

1. Ensure Macuse is added to the correct permission list
2. Try removing and re-adding Macuse
3. Restart Macuse after changing Full Disk Access
4. Check that System Settings shows Macuse as enabled