> ## Documentation Index > Fetch the complete documentation index at: https://pomeroy.app/docs/llms.txt > Use this file to discover all available pages before exploring further. # Introduction > Pomeroy lets your AI assistant read and act on your Mac's own apps: Mail, Calendar, Reminders, Notes, Contacts, Messages, Maps, Weather and Shortcuts. Pomeroy lets your AI assistant reach the apps already on your Mac. Ask about your calendar, find an old email, add a reminder or run a Shortcut, in ordinary conversation, with nothing pasted in. ## What is Pomeroy? Pomeroy is a native macOS menu-bar app that connects AI assistants to your Mac's own applications. It holds the permissions macOS guards and serves them to assistants such as Claude, Cursor, Codex and Raycast as tools they can call on your behalf. It reads your real calendar through EventKit and your real mail through Mail's own automation interface. Pomeroy is read-mostly on purpose. Your assistant can search, read, and create an event, a reminder or a note. It cannot send mail, send a message, delete anything, or read your screen. Those are not settings you could switch on: no such tool exists for the assistant to call. ## How does it work? Pomeroy speaks MCP (Model Context Protocol), an open standard for connecting an AI assistant to tools. Any assistant that speaks MCP can use Pomeroy, so there is nothing Pomeroy-specific for a vendor to add and no lock-in. Each of the ten apps is a switch in Pomeroy, and every switch starts off. When your assistant calls a tool, Pomeroy checks the switch, reads the app on your Mac, and hands the answer back. Nothing passes through a Pomeroy server, because there is no Pomeroy server. ## System requirements | Requirement | Minimum | | ------------- | --------------------------------------------------------- | | macOS version | macOS 15 (Sequoia) or later | | Processor | Apple silicon or Intel Mac | | AI assistant | Anything that speaks MCP and runs on your Mac | | Account | None. Pomeroy has no sign-in | | Price | Free for 50 actions a week. \$19 once to remove the limit | There is no iPhone, iPad or Windows version. ## Supported AI assistants Pomeroy works with any MCP-capable assistant that runs on your Mac, and sets itself up in twenty-four of them for you. Those include Claude Desktop, Claude Code, Cursor, VS Code, Codex, Kiro, LM Studio, Raycast, Zed and Warp. See [Assistants](/docs/assistants/overview) for the full list and a page for each one. An assistant that runs in someone else's cloud cannot reach your Mac at all. That rules out claude.ai in a browser, ChatGPT on the web, and Grok. [Why](/docs/assistants/cloud-assistants). ## Quick start Get Pomeroy running in about five minutes. ### Step 1: download and install 1. [Download Pomeroy](https://pomeroy.app/download) 2. Open the downloaded `.dmg` 3. Drag Pomeroy into your Applications folder 4. Open it. A small tree icon appears in your menu bar ### Step 2: switch on your apps Pomeroy opens a setup window listing the ten apps it can serve. Everything starts switched off. Switch on the ones you want, and macOS asks you to approve each app as you do. | App | What macOS asks for | | --------------------------------------- | ------------------------------------------------------ | | Calendar, Reminders, Contacts, Location | The standard macOS prompt | | Mail, Notes, Shortcuts | Permission to control that app, asked once each | | Messages | A file dialog, where you hand over one file, `chat.db` | | Maps, Weather | Nothing. The toggle is the whole gate | Pomeroy never asks for Full Disk Access, Accessibility or Screen Recording. You can check the last two for yourself in System Settings, where Pomeroy is absent from both lists. [Permissions](/docs/getting-started/permissions). ### Step 3: connect your assistant 1. Open Pomeroy from the menu bar and go to the **Assistants** pane 2. Find your assistant and press **Set up** 3. Restart it if its page says to 4. Ask it what's on your calendar today [The full walkthrough](/docs/getting-started/installation). ## Key features ### Native app integration Ten Apple apps, each behind its own switch, reached only through the automation interface the app itself publishes. | App | What your assistant can do | | ---------------------------- | ----------------------------------------------------------------- | | [Mail](/docs/apps/mail) | Search your inbox and attachments, read a message, list mailboxes | | [Calendar](/docs/apps/calendar) | Read your schedule, create an event, change one you name | | [Reminders](/docs/apps/reminders) | List reminders, create one, mark one done | | [Notes](/docs/apps/notes) | Find a note, read it, start a new one | | [Contacts](/docs/apps/contacts) | Look up a phone number, email address or postal address | | [Messages](/docs/apps/messages) | Search and read your iMessage and SMS conversations | | [Maps](/docs/apps/maps) | Drive times, routes and nearby places | | [Weather](/docs/apps/weather) | Current conditions and the days ahead | | [Location](/docs/apps/location) | Where this Mac is | | [Shortcuts](/docs/apps/shortcuts) | Run a shortcut you already built, by name | Switch one off and its tools stop answering immediately, for every assistant. [Every tool, and what it refuses](/docs/features/overview). ### No screen reading, and no computer use Pomeroy will not click, type, scroll or drive an app's interface, and it holds no grant over your screen. It reaches an app only through the automation interface that app publishes, so an app without one is an app Pomeroy cannot reach. Where you want more, Shortcuts is the door you control. A shortcut you built yourself can do things Pomeroy will not, including sending a message, and Pomeroy only starts the one you name. ### Works with the assistant you already use One button for Claude Desktop, Claude Code, Cursor, VS Code, Codex, Kiro and more. For the rest, Pomeroy puts the exact configuration on your clipboard. Whichever door an assistant comes through, it reaches the same server and obeys the same switches, so connecting a second one adds tools rather than permissions. [How they connect](/docs/configuration/overview). ### Privacy and data flow Pomeroy reads your apps on your Mac and hands the result to the assistant that asked. If that assistant uses a cloud model, what it asked for travels to that model as part of your conversation, the same as text you pasted in, and is governed by that provider's privacy policy. A local model keeps it on your Mac. Nothing from your apps is sent to Pomeroy. There is no Pomeroy server and no Pomeroy account. Pomeroy makes only three kinds of request: a licence check when you enter a key, a signed update check you can switch off, and four pseudonymous usage counts that carry no content from your apps. A test stands behind that promise. [What leaves your Mac](/docs/privacy/what-leaves-your-mac) fails the build if the page and the code disagree. You stay in control through the app switches, the macOS grants themselves, and the local endpoint, which is off until you turn it on. ## Common questions Not for your apps. Mail, Calendar, Reminders, Notes, Contacts, Messages and Shortcuts are read on your Mac. Maps and Weather ask Apple, because that is where the answer lives. Your assistant may need the network for its own model. Pomeroy reads your apps locally and uploads none of it. What your assistant receives then follows that assistant's own data path, which may be local or cloud. Ask about the things you would be happy to paste into that assistant, and read its provider's policy alongside [ours](https://pomeroy.app/privacy). Pomeroy says so plainly. A tool for an app you switched off returns a refusal naming the switch to flip, and never touches your data. A tool that does not exist, such as one for sending mail or deleting a note, cannot be talked into existing. [Troubleshooting](/docs/getting-started/troubleshooting) covers the rest. That is the default. Every app starts off, and you switch on only what you want. You can switch one back off at any time, which takes effect at once for every assistant, and you can take the macOS grant back separately in System Settings. No. Pomeroy is made by Joe Saunderson and works with assistants from several companies. Questions about Pomeroy go to [hello@pomeroy.app](mailto:hello@pomeroy.app). Questions about Claude itself go to Anthropic. Pomeroy is free for 50 actions a week, with no account and no card. One action is one use of one app. \$19 once removes the weekly limit, there is no subscription, and there is a 14-day refund for any reason. [How the allowance works](/docs/licence/free-allowance). ## Quick links * [Installation](/docs/getting-started/installation) sets Pomeroy up on your Mac, from download to first answer * [Configuration](/docs/getting-started/configuration) covers Pomeroy's five settings panes * [Permissions](/docs/getting-started/permissions) explains what each toggle grants * [Features](/docs/features/overview) lists ten apps, 27 tools, and every refusal * [Assistants](/docs/assistants/overview) has a page for each one, with the exact configuration * [Troubleshooting](/docs/getting-started/troubleshooting) covers every way Pomeroy can appear not to work ## Learn more * [Frequently asked questions](/docs/faq) gives the longer answers * [How Pomeroy works](/docs/privacy/how-pomeroy-works) is the architecture in one page * [Model Context Protocol](https://modelcontextprotocol.io) is the open standard behind Pomeroy