// troubleshooting guide · espanso

Espanso macOS Accessibility Permission Not Working

Status
Workaround available
platforms:
macOS
updated:
November 15, 2026
reports:
3
Method
how we research
Share

RUNBOOK · espanso/macos-accessibility-permission3 FIXES

// quick answer

On macOS, Espanso needs Accessibility permission. If it is set but nothing expands, remove and re-add the entry and restart Espanso.

Most likely fix: Re-grant permission

How to fix it

// try these in order, the most common fix is first

  1. FIX 1Re-grant permission

    1. 01Open System Settings > Privacy & Security > Accessibility
    2. 02Remove Espanso with the minus button
    3. 03Run `espanso start` and add it again when prompted, switch it on
    Did this fix it?
  2. FIX 2Restart the service

    1. 01Run `espanso restart`
    2. 02Run `espanso status` to confirm it is running
    Did this fix it?
  3. FIX 3Follow the macOS install steps for the security warning

    1. 01Open the app once from Applications
    2. 02Approve it in Privacy & Security if blocked
    Did this fix it?

Symptoms

Security warning on first start, or the permission appears on but Espanso does nothing.

Why it happens

  • C-01Permission never granted
  • C-02Entry stale after update or reinstall
  • C-03Binary quarantined after download

// this guide also covers

  • espanso accessibility permission
  • espanso macos not working
  • espanso sequoia

Still not working?

If Espanso keeps failing, you're not alone. See every Espanso problem users report or the alternatives people switch to.

Have an app idea? Our small team builds any software: web and mobile apps, games, desktop, AI tools. Price agreed together.

Talk to us

Watch Espanso Get an email when its price changes, it has an outage, or we publish a new fix. No spam.

Fixed it? Share this guide

Other Espanso errors

All 12 Espanso errors and fixes →