Tool reference

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.

Pomeroy serves 27 tools. This is all of them, in the order an assistant sees them in tools/list.

Read means the tool only reads your data. Write means it can change something. Every write is listed here, and there are six.

Allowance

Tool	App	Kind	What it does
pomeroy_usage	None	Read	How much of this week’s allowance is left: the limit, calls used, calls remaining, and when the count refills. Asking is free and never counts against the limit

Calendar

Tool	Kind	What it does
calendar_today	Read	Today’s events. No arguments; “today” resolves in your Mac’s local time zone
calendar_events	Read	Events across whole local days, from through to inclusive
calendar_create_event	Write	Creates an event and returns it as saved, with its id
calendar_update_event	Write	Updates fields of an event by id. Only the fields sent change; a recurring event changes only that occurrence

Reminders

Tool	Kind	What it does
reminders_list	Read	Reminders, incomplete only by default, soonest due first. Can be filtered to one list
reminders_create	Write	Creates a reminder and returns it as saved, with its id
reminders_complete	Write	Marks a reminder done by id. Safe to repeat

Contacts

Tool	Kind	What it does
contacts_search	Read	Searches by name, organisation, email address or phone-number fragment. Case-insensitive

Notes

Tool	Kind	What it does
notes_list	Read	Every note’s id and name, sorted. Bodies excluded
notes_read	Read	One note in full, by id, as plain text
notes_create	Write	Creates a note and returns it as saved, with its id

Mail

Tool	Kind	What it does
mail_mailboxes	Read	Every mailbox with account, message count and unread count
mail_list	Read	Messages in one mailbox, newest first, with ids. Bodies excluded
mail_read	Read	One message in full, by id. Cut at 4,000 characters, and says so
mail_search	Read	Searches headers (default) or bodies via the local index. All tokens must match
mail_unread	Read	Unread messages, newest first, with the total unread count
mail_index	Read	Builds the local body index now and reports what it covered

Messages

Tool	Kind	What it does
messages_conversations	Read	Recent conversations, most recently active first, with ids
messages_search	Read	Searches message text, newest match first. Plain text, no syntax
messages_read	Read	One conversation’s recent messages, newest first, by id

Maps

Tool	Kind	What it does
maps_search_places	Read	Places near a named place. Both arguments are names, never coordinates
maps_directions	Read	Routes between two named places. Driving or walking

Weather

Tool	Kind	What it does
weather_current	Read	Current conditions for a named place, with the instant measured
weather_forecast	Read	Daily forecast for a named place: highs, lows, chance of rain

Location

Tool	Kind	What it does
location_current	Read	Where this Mac is, with the accuracy in metres and when the fix was taken

Shortcuts

Tool	Kind	What it does
shortcuts_list	Read	The shortcuts on this Mac, by name, sorted
shortcuts_run	Write	Runs one shortcut by its exact name and returns what it produced

The six writes, in one place

Everything Pomeroy can change on your Mac:

Tool	What it changes	Can it destroy anything?
calendar_create_event	Adds an event	No
calendar_update_event	Changes fields on one event you named	It overwrites the fields it was sent
reminders_create	Adds a reminder	No
reminders_complete	Marks one reminder done	No
notes_create	Adds a note	No
shortcuts_run	Whatever your shortcut does	Whatever you built it to do

There is no tool that deletes anything, in any app. There is no tool that sends mail or a message. There is no tool that edits a contact or an existing note.

What gates a call

Two things, both of which must be open:

1. The toggle for the tool’s app, in Pomeroy’s settings.
2. The grant macOS holds for that app.

A tool whose app is switched off returns a refusal naming the switch to flip, and never touches your data. pomeroy_usage sits above both gates, because it reads nothing but Pomeroy’s own bookkeeping.

What Pomeroy can do

The same information per app, with what each refuses to do.