# Pomeroy

> Documentation for Pomeroy, the macOS menu-bar app that connects Claude and other AI assistants to Mail, Calendar, Reminders, Notes, Contacts, Messages, Maps, Weather and Shortcuts over MCP.

- [Introduction](https://pomeroy.app/docs/index.md): Pomeroy lets your AI assistant read and act on your Mac's own apps: Mail, Calendar, Reminders, Notes, Contacts, Messages, Maps, Weather and Shortcuts.
- [Frequently asked questions](https://pomeroy.app/docs/faq.md): What your AI assistant can read on your Mac, what Pomeroy refuses to do, where your data goes, which assistants work, who makes it, and what it costs.
- [Installation](https://pomeroy.app/docs/getting-started/installation.md): Download Pomeroy, switch on the apps you want, connect your AI assistant, and get your first answer from your own Mac in about five minutes.
- [Configuration](https://pomeroy.app/docs/getting-started/configuration.md): Pomeroy's five settings panes: the apps your assistant can reach, the assistants themselves, the two ways in, your licence, and updates.
- [Permissions](https://pomeroy.app/docs/getting-started/permissions.md): Every app in Pomeroy starts switched off. This is what a toggle does, what macOS asks you for when you switch one on, and how to change your mind.
- [Troubleshooting](https://pomeroy.app/docs/getting-started/troubleshooting.md): Every way Pomeroy can appear not to work, and the fix: missing tools, an app switched off, the weekly allowance, weather, updates and permissions.
- [What Pomeroy can do](https://pomeroy.app/docs/features/overview.md): Pomeroy serves 27 MCP tools across ten Apple apps. This is what a tool is, what gates one, what Pomeroy refuses to do, and where to find the detail for each app.
- [Calendar](https://pomeroy.app/docs/apps/calendar.md): Your AI assistant can read your Apple Calendar, create an event, and change one you name. It never deletes an event and cannot send invitations.
- [Reminders](https://pomeroy.app/docs/apps/reminders.md): Your AI assistant can list your reminders, create one, and mark one done. It cannot delete a reminder, rename a list, or change a reminder after it is made.
- [Notes](https://pomeroy.app/docs/apps/notes.md): Your AI assistant can find a note, read it in full, and start a new one. It never edits, moves, or deletes an existing note.
- [Mail](https://pomeroy.app/docs/apps/mail.md): Your AI assistant can list your mailboxes, read and search your mail, and find unread messages. Pomeroy cannot send, reply, delete, move, or mark anything read.
- [Messages](https://pomeroy.app/docs/apps/messages.md): Your AI assistant can search and read your iMessage and SMS conversations. Pomeroy cannot send a message, and never asks for Full Disk Access.
- [Contacts](https://pomeroy.app/docs/apps/contacts.md): Your AI assistant can look people up in your Apple Contacts. Pomeroy never creates, edits, or deletes a contact, because there is no tool for it.
- [Maps](https://pomeroy.app/docs/apps/maps.md): Your AI assistant can find places and route between them using Apple Maps. Both tools take place names, never your location.
- [Weather](https://pomeroy.app/docs/apps/weather.md): Your AI assistant can read current conditions and the daily forecast for a named place, from Apple's WeatherKit, the same source the Weather app uses.
- [Location](https://pomeroy.app/docs/apps/location.md): One tool, which reports where this Mac is. It is the only Pomeroy tool that needs the Location grant, because Maps and Weather take place names instead.
- [Shortcuts](https://pomeroy.app/docs/apps/shortcuts.md): Your AI assistant can run a Shortcut you already built, by name. It cannot create, edit, or delete one, and this is how Pomeroy reaches apps it has no tools for.
- [Tool reference](https://pomeroy.app/docs/apps/tool-reference.md): Every MCP tool Pomeroy serves, in wire order: its name, what it does, the app whose toggle gates it, and whether it reads or writes.
- [AI assistants](https://pomeroy.app/docs/assistants/overview.md): The 24 AI assistants Pomeroy sets itself up in, what setup does in each, and what to do when yours is not on the list.
- [Connect Pomeroy to Claude Desktop](https://pomeroy.app/docs/assistants/claude-desktop.md): Pomeroy opens its Claude extension and Claude Desktop asks to install it. No file to find, no Terminal. Then Claude Desktop can reach Mail, Calendar, Reminders, Notes, Contacts, Messages, Maps, Weather and Shortcuts on your Mac, each app behind its own switch.
- [Connect Pomeroy to Claude Code](https://pomeroy.app/docs/assistants/claude-code.md): Pomeroy runs Claude Code's own command to register itself for every project. Start a new session and the tools are there. Then Claude Code can reach Mail, Calendar, Reminders, Notes, Contacts, Messages, Maps, Weather and Shortcuts on your Mac, each app behind its own switch.
- [Connect Pomeroy to Cursor](https://pomeroy.app/docs/assistants/cursor.md): Pomeroy opens Cursor's install link. Cursor shows the command and asks you to confirm. Then Cursor can reach Mail, Calendar, Reminders, Notes, Contacts, Messages, Maps, Weather and Shortcuts on your Mac, each app behind its own switch.
- [Connect Pomeroy to VS Code](https://pomeroy.app/docs/assistants/vscode.md): Pomeroy opens VS Code's install link. VS Code asks you to trust the server, then starts it. Then VS Code can reach Mail, Calendar, Reminders, Notes, Contacts, Messages, Maps, Weather and Shortcuts on your Mac, each app behind its own switch.
- [Connect Pomeroy to VS Code Insiders](https://pomeroy.app/docs/assistants/vscode-insiders.md): Pomeroy opens the Insiders install link. VS Code Insiders asks you to trust the server, then starts it. Then VS Code Insiders can reach Mail, Calendar, Reminders, Notes, Contacts, Messages, Maps, Weather and Shortcuts on your Mac, each app behind its own switch.
- [Connect Pomeroy to Codex](https://pomeroy.app/docs/assistants/codex.md): Pomeroy runs Codex's own command. One registration reaches the Codex CLI, the IDE extension and the ChatGPT desktop app. Then Codex can reach Mail, Calendar, Reminders, Notes, Contacts, Messages, Maps, Weather and Shortcuts on your Mac, each app behind its own switch.
- [Connect Pomeroy to LM Studio](https://pomeroy.app/docs/assistants/lm-studio.md): Pomeroy writes one entry to LM Studio's mcp.json. LM Studio loads it the moment the file is saved. Then LM Studio can reach Mail, Calendar, Reminders, Notes, Contacts, Messages, Maps, Weather and Shortcuts on your Mac, each app behind its own switch.
- [Connect Pomeroy to Kiro](https://pomeroy.app/docs/assistants/kiro.md): Pomeroy opens Kiro's install link and Kiro asks to confirm. It picks the server up without a restart. Then Kiro can reach Mail, Calendar, Reminders, Notes, Contacts, Messages, Maps, Weather and Shortcuts on your Mac, each app behind its own switch.
- [Connect Pomeroy to Cherry Studio](https://pomeroy.app/docs/assistants/cherry-studio.md): Pomeroy opens Cherry Studio's install link and Cherry Studio asks to confirm, twice. Then Cherry Studio can reach Mail, Calendar, Reminders, Notes, Contacts, Messages, Maps, Weather and Shortcuts on your Mac, each app behind its own switch.
- [Connect Pomeroy to Cline](https://pomeroy.app/docs/assistants/cline.md): Pomeroy writes one entry to the settings file every Cline surface shares. No restart needed. Then Cline can reach Mail, Calendar, Reminders, Notes, Contacts, Messages, Maps, Weather and Shortcuts on your Mac, each app behind its own switch.
- [Connect Pomeroy to AnythingLLM](https://pomeroy.app/docs/assistants/anythingllm.md): Pomeroy writes one entry to AnythingLLM's server file. Press Refresh in Agent Skills and it is there. Then AnythingLLM can reach Mail, Calendar, Reminders, Notes, Contacts, Messages, Maps, Weather and Shortcuts on your Mac, each app behind its own switch.
- [Connect Pomeroy to Gemini CLI](https://pomeroy.app/docs/assistants/gemini-cli.md): Pomeroy runs Gemini CLI's own command with user scope. Run /mcp reload, or start a new session. Then Gemini CLI can reach Mail, Calendar, Reminders, Notes, Contacts, Messages, Maps, Weather and Shortcuts on your Mac, each app behind its own switch.
- [Connect Pomeroy to GitHub Copilot CLI](https://pomeroy.app/docs/assistants/copilot-cli.md): Pomeroy runs Copilot CLI's own command. The server is available immediately, with no restart. Then GitHub Copilot CLI can reach Mail, Calendar, Reminders, Notes, Contacts, Messages, Maps, Weather and Shortcuts on your Mac, each app behind its own switch.
- [Connect Pomeroy to OpenCode](https://pomeroy.app/docs/assistants/opencode.md): Pomeroy runs OpenCode's own command, which covers the terminal tool and OpenCode Desktop together. Then OpenCode can reach Mail, Calendar, Reminders, Notes, Contacts, Messages, Maps, Weather and Shortcuts on your Mac, each app behind its own switch.
- [Connect Pomeroy to Raycast](https://pomeroy.app/docs/assistants/raycast.md): Pomeroy copies the three values Raycast asks for. Paste them into Raycast's Install MCP Server form. Then Raycast can reach Mail, Calendar, Reminders, Notes, Contacts, Messages, Maps, Weather and Shortcuts on your Mac, each app behind its own switch.
- [Connect Pomeroy to ChatWise](https://pomeroy.app/docs/assistants/chatwise.md): Pomeroy copies the configuration as JSON. ChatWise imports it from the clipboard in one step. Then ChatWise can reach Mail, Calendar, Reminders, Notes, Contacts, Messages, Maps, Weather and Shortcuts on your Mac, each app behind its own switch.
- [Connect Pomeroy to goose](https://pomeroy.app/docs/assistants/goose.md): Pomeroy copies a YAML block for goose's config file. Paste it in and start a new session. Then goose can reach Mail, Calendar, Reminders, Notes, Contacts, Messages, Maps, Weather and Shortcuts on your Mac, each app behind its own switch.
- [Connect Pomeroy to Windsurf](https://pomeroy.app/docs/assistants/windsurf.md): Pomeroy copies the configuration for Windsurf's mcp_config.json. Paste it in and press refresh in the Cascade panel. Then Windsurf can reach Mail, Calendar, Reminders, Notes, Contacts, Messages, Maps, Weather and Shortcuts on your Mac, each app behind its own switch.
- [Connect Pomeroy to Warp](https://pomeroy.app/docs/assistants/warp.md): Pomeroy copies the configuration for Warp's .mcp.json. Warp also reads Claude Code's setup, so you may already be done. Then Warp can reach Mail, Calendar, Reminders, Notes, Contacts, Messages, Maps, Weather and Shortcuts on your Mac, each app behind its own switch.
- [Connect Pomeroy to Zed](https://pomeroy.app/docs/assistants/zed.md): Pomeroy copies a context_servers block for Zed's settings.json. Paste it in, and your comments stay yours. Then Zed can reach Mail, Calendar, Reminders, Notes, Contacts, Messages, Maps, Weather and Shortcuts on your Mac, each app behind its own switch.
- [Connect Pomeroy to Perplexity](https://pomeroy.app/docs/assistants/perplexity.md): Pomeroy copies the two values Perplexity's Add Connector form asks for. Paste them in and save. Then Perplexity can reach Mail, Calendar, Reminders, Notes, Contacts, Messages, Maps, Weather and Shortcuts on your Mac, each app behind its own switch.
- [Connect Pomeroy to JetBrains AI Assistant](https://pomeroy.app/docs/assistants/jetbrains.md): Pomeroy copies the JSON that JetBrains AI Assistant's As JSON field takes. Paste it once and every JetBrains IDE has it. Then JetBrains AI Assistant can reach Mail, Calendar, Reminders, Notes, Contacts, Messages, Maps, Weather and Shortcuts on your Mac, each app behind its own switch.
- [Connect Pomeroy to BoltAI](https://pomeroy.app/docs/assistants/boltai.md): Pomeroy copies the JSON BoltAI's plugin settings take. Paste it and choose Reload Config. Then BoltAI can reach Mail, Calendar, Reminders, Notes, Contacts, Messages, Maps, Weather and Shortcuts on your Mac, each app behind its own switch.
- [Connect Pomeroy to Msty Studio](https://pomeroy.app/docs/assistants/msty-studio.md): Pomeroy copies the name and the tool configuration Msty Studio's Toolbox asks for. Then Msty Studio can reach Mail, Calendar, Reminders, Notes, Contacts, Messages, Maps, Weather and Shortcuts on your Mac, each app behind its own switch.
- [Cloud assistants](https://pomeroy.app/docs/assistants/cloud-assistants.md): Why claude.ai, ChatGPT on the web and Grok cannot reach Pomeroy, even though Pomeroy has an HTTP endpoint, and what to use instead.
- [Guides](https://pomeroy.app/docs/guides/overview.md): Task-shaped guides to what you can do once your assistant can see your Mac, with the prompts that answer each one.
- [Plan your week with an AI assistant on your Mac](https://pomeroy.app/docs/guides/plan-your-week-on-your-mac.md): Plan your week by asking. Pomeroy lets your AI assistant read your Apple Calendar and Reminders on your Mac, add events and reminders, and tick things off. It never deletes either.
- [Find anything in your email with an AI assistant](https://pomeroy.app/docs/guides/find-anything-in-your-email.md): Find any email by asking. Pomeroy lets your AI assistant search your Apple Mail on your Mac by sender, subject, and what a message says. It cannot send, delete, or move a single message.
- [Run Shortcuts by asking your AI assistant](https://pomeroy.app/docs/guides/run-shortcuts-by-asking.md): Run your Apple Shortcuts by asking. Pomeroy runs any shortcut you have already built, by name, and reads back the result. It cannot create or change a shortcut.
- [How an assistant reaches Pomeroy](https://pomeroy.app/docs/configuration/overview.md): Pomeroy runs one MCP server and serves it through two ways in: the direct path on this Mac, and an HTTP endpoint on loopback. This is what each is for.
- [Stdio](https://pomeroy.app/docs/configuration/stdio.md): The default way in: the Claude Desktop extension and the byte pipe inside Pomeroy's app bundle. No port, no credential, and nothing to revoke.
- [HTTP local endpoint](https://pomeroy.app/docs/configuration/http-endpoint.md): One streamable HTTP address on this Mac's loopback, off until you switch it on, for an assistant that cannot start a program: a container, a VM, a runner, or a client that takes only a URL.
- [How Pomeroy works](https://pomeroy.app/docs/privacy/how-pomeroy-works.md): Three doors, one contract. How an assistant's request reaches your Mac, what holds the permissions, and why the bridges do not understand MCP.
- [What leaves your Mac](https://pomeroy.app/docs/privacy/what-leaves-your-mac.md): Every request Pomeroy makes, and everything that can reach it. Your calendar, mail, messages, contacts, notes and reminders never leave your Mac, and a test fails if this page and the code disagree.
- [What Pomeroy asks macOS for](https://pomeroy.app/docs/privacy/what-pomeroy-asks-macos-for.md): The macOS permissions Pomeroy requests, the one file you hand it, and the two grants it will never ask for: Accessibility and Screen Recording.
- [The free allowance](https://pomeroy.app/docs/licence/free-allowance.md): Pomeroy is free for 50 actions a week, with no account and no card. This is what counts as an action, what happens when they run out, and how to check what is left.
- [Buy and activate](https://pomeroy.app/docs/licence/buy-and-activate.md): $19 once removes the weekly limit. This is what the checkout sends, what activation sends, and what happens when Pomeroy is offline.
- [Moving Macs and refunds](https://pomeroy.app/docs/licence/moving-and-refunds.md): How to move your Pomeroy licence to a new Mac, and how the 14-day refund works.
- [Uninstall Pomeroy](https://pomeroy.app/docs/uninstall.md): How to remove Pomeroy completely, including its settings, the pseudonymous identifier the usage counts share, and the macOS grants it holds.

## Optional

- [Download](https://pomeroy.app/download)
- [Pricing](https://pomeroy.app/pricing)