Open-source project
p0deje/Maccy avatar
p0deje/Maccy

Maccy: a keyboard-first clipboard manager for macOS

Lightweight clipboard manager for macOS

21,762 stars1,178 forksSwiftMIT

At a glance

What is it?
Maccy keeps a searchable history of what you copy on macOS Sonoma 14 or higher. It is small, MIT licensed, and installs with a single Homebrew command, but it depends on Accessibility permissions to paste for you.
Who is it for?
Adopt Maccy if you work keyboard-first on macOS Sonoma 14 or higher and want copy history without a subscription or a cloud account. Skip it if you need a clipboard that syncs between an iPhone and a Mac, since the README documents no iOS client, or if you cannot grant Accessibility permission, because automatic paste depends on it.
Can I use it commercially?
Yes. MIT is a permissive licence: you can use, modify and sell software built on it, as long as you keep its copyright and licence notices.
Is it still maintained?
Yes. The repository last received commits 25 days ago.
What is it written in?
Mainly Swift, according to GitHub's language statistics.

Answers come from the project's GitHub data, last synced on September 29, 2026, and from our analysis. They are not legal advice.

Editorial analysis

What Maccy solves, and who it is actually for

macOS keeps exactly one clipboard. Copy a second thing and the first is gone. Maccy sits in the menu bar and keeps the history instead, so the paragraph you copied ten minutes ago is still retrievable after you have copied three other things. The README frames the whole product around that: it "keeps the history of what you copy and lets you quickly navigate, search, and use previous clipboard contents."

The audience is narrow and specific. Someone who copies and pastes all day, prefers the keyboard to the trackpad, and does not want a subscription or an account. The feature list reads: lightweight and fast, keyboard-first, secure and private, native UI, open source and free. Those are claims from the project, not measurements, but the shape of the tool matches them. There is no server component and no sync service described anywhere in the README, which is the main reason the privacy claim is plausible rather than marketing.

What it is not is a cross-device clipboard. Universal Clipboard is Apple's own mechanism for moving a copy between a Mac and an iPhone, and Maccy's only documented relationship with it is a FAQ entry about ignoring its copies. If device-to-device sync is the requirement, this is the wrong tool and the README will not lead you to a workaround.

How the history, search and pinning work

The mechanism is a polling loop, not a system notification. The README states that Maccy checks the clipboard every 500 ms by default, and exposes that interval as a setting. So the design is: read the pasteboard on a timer, compare against what is already in history, store new entries, and render the list in a popup window. That explains both the low overhead and the one behavioural quirk worth knowing. A copy that appears and is overwritten inside the polling window can be missed entirely, which is why the project offers a way to shorten the interval rather than a way to subscribe to pasteboard events.

Retrieval is keyboard-first. SHIFT + COMMAND + C opens the popup or you click the menu bar icon, you type to filter, and then the modifier you hold decides what happens. ENTER copies the item back to the clipboard. OPTION + ENTER copies and pastes into the frontmost app. OPTION + SHIFT + ENTER pastes without formatting. Deletion is OPTION + DELETE, and OPTION + P pins an item so it stays at the top of the list with a permanent keyboard shortcut assigned to it. Pinned items survive the normal clear, which removes only unpinned entries unless you hold the extra modifiers.

There are two ignore paths. The global switch is `ignoreEvents`, which stops Maccy recording anything at all until you turn it back off, useful for a sensitive copy you do not want stored. The finer path is pasteboard types: the README says Maccy ignores confidential or temporary types by default, and lists `org.nspasteboard.TransientType`, `org.nspasteboard.ConcealedType` and `org.nspasteboard.AutoGeneratedType` as always ignored, plus a removable default set that includes password manager markers such as `com.agilebits.onepassword` and `net.antelle.keeweb`. That list is the security boundary. An app that does not mark its pasteboard data as concealed will have its copies recorded.

Installing Maccy with Homebrew and a first real use

The README gives two install routes: download the latest release from the releases page, or use Homebrew. The Homebrew route is one command and handles upgrades.

bash
brew install maccy

After installing, launch Maccy. Maccy requires macOS Sonoma 14 or higher, so on an older release the app will not run regardless of how it was installed. The most recent releases listed for the project are 2.7.1 from 2026-08-10, 2.7.0 from 2026-07-28 and 2.6.1 from 2025-11-27.

Now copy two or three different pieces of text from any app, then press SHIFT + COMMAND + C. The popup should list them, newest first. Type a few characters to filter, then press ENTER to put the highlighted item back on the clipboard, or OPTION + ENTER to paste it directly into the app you were in.

If OPTION + ENTER does nothing, the README's first FAQ entry covers it: enable "Paste automatically" in Preferences, and add Maccy to System Settings, Privacy & Security, Accessibility. Without that permission Maccy can still manage the clipboard, but it cannot synthesize the paste keystroke for you.

Two settings are worth changing on day one if the defaults do not suit you. The polling interval can be shortened, and the global ignore switch can be toggled from the terminal:

bash
defaults write org.p0deje.Maccy clipboardCheckInterval 0.1
defaults write org.p0deje.Maccy ignoreEvents true
defaults write org.p0deje.Maccy ignoreEvents false

The first line sets a 100 ms check interval instead of the 500 ms default, at the cost of more frequent pasteboard reads. The second and third lines bracket a sensitive copy: turn recording off, copy the secret, turn it back on. The README describes exactly this workflow.

Where Maccy gets in the way

The 500 ms polling interval is the honest limitation. Any clipboard workflow that relies on copying several values in rapid succession, such as scripted data entry or a macro that copies and pastes in a tight loop, can outrun the poller. The documented mitigation is to lower `clipboardCheckInterval`, but the README does not state what the practical floor is, so the safe assumption is that you are trading CPU wakeups for coverage and should test your own workflow rather than trust a number.

The second limitation is the pasteboard type allowlist. Ignoring by type only works when the source application marks its data. The README points readers at Pasteboard-Viewer to inspect which custom types an app uses, and links to an issue showing the approach applied to Adobe InDesign. That is a manual, per-application exercise. Nothing in the README suggests Maccy can infer that a given app is sensitive.

The third is hotkey collisions. A FAQ entry exists precisely because assigning a hotkey can fail with a message that the combination is already used elsewhere in the system, and the fix is to go into System Settings, Keyboard, Keyboard Shortcuts, disable the conflicting binding, restart Maccy and reassign. That is a system-level constraint rather than a Maccy bug, but it is friction on first setup and it recurs whenever macOS adds a shortcut that overlaps yours.

Finally, the README opens with a warning that fake sites such as `maccyapp.net` and `maccyapp.com` distribute malware disguised as Maccy, and that maccy.app is the only official website. Anyone installing from a search result rather than from the GitHub releases page or Homebrew is exposed to that.

Maccy against a clipboard manager with sync

The clearest alternative category is the clipboard manager that stores history in a synced account so the same list appears on every device you own. The difference is architectural, not cosmetic. Maccy's README describes a local menu bar app with a local history and a terminal-accessible preference domain (`org.p0deje.Maccy`); there is no account, no server and no documented sync layer. A synced manager inverts that: the local app becomes a client, the history lives remotely, and the privacy properties change accordingly, because your copied text now leaves the machine.

That trade is the whole decision. If you copy passwords, tokens, customer data or unreleased text, local-only storage plus the ignore-type list is a defensible position and the README's security section is written for that reader. If you move between a laptop and a desktop all day and want one history, Maccy does not attempt to solve it, and the README does not pretend otherwise. There is also a middle option worth naming: Apple's own Universal Clipboard already moves a single copy between devices, and Maccy's documented answer to it is a FAQ entry on how to ignore those copies, not how to capture them.

On cost, the comparison is simpler. Maccy is MIT licensed and the README describes it as "open source and free." A FAQ entry in the README asks whether Maccy is still free, which tells you users have asked; the repository's licence file and the absence of any pricing mechanism in the install instructions are the evidence available here.

Maintenance, upgrades and what the licence means for you

The repository is not archived, and the last push was on 2026-09-04. Releases have been arriving at a modest cadence: 2.6.1 in November 2025, then 2.7.0 and 2.7.1 in July and August 2026. For a menu bar utility that is a reasonable rhythm, and the presence of `appcast.xml` in the repository root indicates the project ships its own update feed rather than relying solely on Homebrew for upgrades.

Upgrade cost is low if you installed through Homebrew, since the package manager tracks the formula. If you installed the release build directly, the appcast is the update path. There is no migration story documented in the README for the preference domain, so settings written with `defaults write org.p0deje.Maccy ...` are the ones you should expect to keep working across versions; if a future release renames a key, the README is where that would surface.

The MIT licence is permissive: it allows use, modification and redistribution with the licence and copyright notice retained. That matters if you intend to fork Maccy or ship it inside an organisation. It does not give you any warranty, and nothing here is legal advice; if you are redistributing, read the LICENSE file in the repository rather than this paragraph. One practical consequence of the fork-friendly licence is that the malware sites impersonating Maccy are not constrained by it at all, which is why the README's warning points at the domain rather than at the binary.

Editorial conclusion

Adopt Maccy if you work keyboard-first on macOS Sonoma 14 or higher and want copy history without a subscription or a cloud account. Skip it if you need a clipboard that syncs between an iPhone and a Mac, since the README documents no iOS client, or if you cannot grant Accessibility permission, because automatic paste depends on it. Before relying on it, verify two things on your own machine: that SHIFT + COMMAND + C opens the popup without colliding with a system shortcut, and that the pasteboard types your sensitive apps use are covered by the Ignore settings.

Frequently asked questions

What is Maccy and what does it do?

Maccy is a lightweight clipboard manager for macOS that keeps the history of what you copy and lets you navigate, search and reuse previous clipboard contents. It runs in the menu bar and opens with SHIFT + COMMAND + C.

How do I install Maccy on a Mac?

Download the latest version from the releases page, or run brew install maccy. Maccy requires macOS Sonoma 14 or higher, and only maccy.app is the official website.

How do I install Maccy with Homebrew?

Run brew install maccy in a terminal. Homebrew installs the app and tracks the formula for later upgrades.

How do I use Maccy?

Press SHIFT + COMMAND + C to open the popup, type to filter the history, then press ENTER to copy an item, OPTION + ENTER to paste it, or OPTION + SHIFT + ENTER to paste without formatting. OPTION + P pins an item and OPTION + DELETE removes one.

Is Maccy free?

Maccy is MIT licensed, and the README describes it as open source and free. The repository shows no pricing mechanism in the install instructions.

Official sources

  1. License: MIT
  2. p0deje/Maccy on GitHub
  3. Project website
  4. README
  5. Releases
Add this badge to your README

If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.

Add this badge to your README

markdown
[![Hysen Labs](https://hysenlabs.com/badge/p0deje-maccy.svg)](https://hysenlabs.com/projects/p0deje-maccy)