Before you start. You need macOS 15 or later and an AI assistant that runs
on your Mac. Pomeroy sets itself up in twenty-four of them, and any assistant
that can start a local MCP server works from the same configuration.No assistant yet? Claude Desktop is free and a
good first one. An assistant that runs in someone else’s cloud, such as
claude.ai or ChatGPT on the web, cannot reach your Mac at all.
Why.
Install Pomeroy
Download Pomeroy, open the disk image, and
drag Pomeroy into your Applications folder. Open it.Pomeroy adds a small tree icon to your menu bar and opens a setup window. It
has no Dock icon and no main window. The menu bar is where it lives.
Choose the apps your assistant can reach
The setup window shows the ten apps Pomeroy can serve. Everything starts
switched off. Switch on the ones you want.Start with Calendar if you just want to see this work.As you switch each one on, macOS asks you to approve it. The prompt names
Pomeroy and it comes from macOS, not from us. Nothing is requested for an
app you leave off. What each app asks for.
Connect your assistant
Pomeroy lists the assistants it finds on your Mac. Find yours and press
Set up.What that does depends on the assistant, and Pomeroy picks whichever
mechanism its own vendor documents: an extension, an install link, its own
CLI, its configuration file, or your clipboard. Your assistant’s own page
says which, and how to check it worked.
Find your assistant
All 24, with the exact configuration for each.
Restart it, if it needs it
Assistants differ. Claude Desktop and Codex want a full quit and reopen;
Claude Code and goose want a new session; most editors pick the change up on
their own. Pomeroy shows the right line for yours when setup finishes, and
so does its page here.
Ask something
In your assistant, ask:It calls Pomeroy, Pomeroy reads your Mac’s calendar, and the answer comes
back. That is the whole loop.
Try a few more
Each of these uses a different app. They only work for apps you switched on.What just happened
Your assistant did not get access to your Mac. It got access to a fixed list of tools, and each tool does exactly one thing. When you asked about your calendar, it called a tool namedcalendar_today.
Pomeroy checked that your Calendar toggle was on, read today’s events through
EventKit, the same interface the Calendar app uses, and handed the result
back. Your events then became part of your conversation with that assistant,
exactly like text you had pasted in.
Nothing was sent to a Pomeroy server, because there isn’t one.
What leaves your Mac is the full list of
requests Pomeroy makes, and a test fails if that page and the code disagree.
If nothing showed up
Your assistant says it has no Pomeroy tools
Your assistant says it has no Pomeroy tools
Most assistants read their server list when they start. Quit it fully and
open it again; on a Mac that means Quit, not closing the window. Claude
Code and goose need a new session instead.Still nothing? See An assistant cannot see the
tools.
It says an app is switched off in Pomeroy
It says an app is switched off in Pomeroy
That is Pomeroy answering, and it is working correctly: you asked about an
app whose toggle is off. Click the menu-bar icon, choose Settings,
switch the app on, and ask again.
Your assistant is not in Pomeroy's list
Your assistant is not in Pomeroy's list
Any assistant that can start a local MCP server works. Copy the
configuration from any assistant’s page and paste it
wherever that assistant keeps its MCP servers. If it takes a URL rather than
a command, it wants the local endpoint
instead.
macOS says Pomeroy cannot be opened
macOS says Pomeroy cannot be opened
Pomeroy is signed and notarised by Apple, so this normally means the
download did not finish. Delete it and download it
again.
Next
Configuration
Pomeroy’s settings: apps, the endpoint, updates and your licence.
Permissions
What each toggle grants, and what macOS asks you for.
Guides
Whole jobs, end to end, with the asks in order.
The free allowance
What counts as an action, and what happens at 50.