Quickstart

Install Pomeroy, switch on the apps you want, connect Claude Desktop, and get your first answer from your own Mac in about five minutes.

By the end of this page Claude will answer a question about your own calendar, using data that never leaves your Mac.

Before you start. You need macOS 15 or later, and Claude Desktop installed. Claude Desktop is Anthropic’s app, it is free, and Pomeroy cannot install it for you — get it here if you do not have it.

Using something other than Claude Desktop? Follow steps 1 and 2, then pick your assistant on pomeroy.app/connect — all 24, each with its own snippet. The three doors explains what those snippets are doing.

1. 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.

2. Choose the apps Claude 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.

   You can change your mind at any time: click the menu-bar icon and choose Settings. Switching an app off takes its tools away immediately.

3. Install the Claude extension

   Press Set up Claude extension. Claude Desktop opens and asks to install it. Approve it.

   There is no file to find, no claude_desktop_config.json to edit, and no Terminal command.

4. Restart Claude Desktop

   Quit Claude Desktop completely and open it again. Claude reads its extension list at launch, so a running copy will not see the new tools.

5. Ask something

   In Claude Desktop, ask:

   What's on my calendar today?
   

   Claude 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.

Calendar

Am I free on Friday afternoon?

What just happened

Claude 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, Claude called a tool named calendar_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 Claude, 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

Claude says it has no Pomeroy tools

Claude Desktop reads its extensions at launch. Quit it completely — Claude → Quit Claude, not just closing the window — and open it again.

Still nothing? See Claude cannot see Pomeroy’s tools.

Claude 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.

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

Choose your apps

What each toggle grants, and what macOS asks you for.

Apps and tools

Every tool, per app, with what it refuses to do.

The three doors

One Mac can serve several assistants at once. This is how they get in.

The free allowance

What counts as an action, and what happens at 50.