Maccy troubleshooting guide (2026)

Permissions & pasting

If Maccy opens but pressing Return does not paste, it lacks Accessibility permission — the single most common issue. Grant it in System Settings → Privacy & Security → Accessibility. Background and full-disk details: Maccy permissions explained.

Problem-by-problem

It stopped working after a macOS update

Updates often reset permissions. Re-grant Accessibility and update Maccy → full fix.

It is not capturing what I copy

Check it is running, review the ignore list, and remember concealed/password items are skipped by design → full fix.

My keyboard shortcut does nothing

Usually a system conflict or secure input in password fields; switch to Command-Shift-C → full fix.

The menu-bar icon disappeared

Often hidden by a crowded menu bar or a menu-bar manager → full fix.

My history keeps disappearing

The size limit is likely purging items; raise it and pin essentials → full fix.

Maccy crashes on launch

Update, restart, then reset the preferences file → full fix.

I want to remove it completely

Quit, delete the app and its support files → uninstall guide.

When all else fails

1. Update to the latest version (brew upgrade --cask maccy or a fresh .dmg).
2. Reset preferences: move ~/Library/Preferences/org.p0deje.Maccy.plist aside (keeps history).
3. If still broken, back up and remove ~/Library/Application Support/Maccy to rebuild the database.
4. Capture a crash report from Console and open an issue on GitHub.

For setup questions rather than problems, see the documentation and FAQ.

Most common issues and fixes

Issue 1: Shortcut does nothing

Cause: Accessibility permission revoked (most common after macOS updates).

Fix: System Settings → Privacy & Security → Accessibility → toggle Maccy off, then on. Quit and relaunch Maccy.

Issue 2: Items are captured but Return does not paste

Cause: Same — Accessibility permission is missing or disabled.

Fix: Same as Issue 1. Accessibility is required for pasting into other apps.

Issue 3: History disappears after restart

Cause: "Clear on Quit" is enabled in Preferences.

Fix: Maccy Preferences → History → uncheck Clear History on Quit.

Issue 4: Maccy not visible in menu bar

Cause: Menu bar overflow (too many icons), or Maccy is not running.

Fix: Hold Cmd and rearrange icons to make space. On Tahoe: right-click menu bar → Customise. Or use Ice (free) to manage overflow.

Issue 5: Password appeared in history

Cause: Password manager not on ignore list.

Fix: Maccy Preferences → Ignore → add the app's bundle ID. Default list includes 1Password, Bitwarden, Dashlane.

Issue 6: Specific app's copies not captured

Cause: App is on ignore list, or app uses secure clipboard flag.

Fix: Check Preferences → Ignore list. Remove the app if it should not be ignored.

Issue 7: Maccy crashes on startup

Fix: Reset preferences: defaults delete com.p0deje.Maccy. If crash persists, delete the database: rm ~/Library/Application\ Support/Maccy/Maccy.sqlite.

Full fix guides for each issue

• Keyboard shortcut not working — full guide
• Maccy missing from menu bar — full guide
• History not saving between restarts — full guide
• Not capturing clipboard items — full guide
• Crashing on startup — full guide
• Not working after macOS update — full guide

Quick reset commands

# Reset preferences only (does NOT delete history)
defaults delete com.p0deje.Maccy

# Complete reset (DELETES history)
defaults delete com.p0deje.Maccy
rm -rf ~/Library/Application\ Support/Maccy