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

# What Pomeroy can do

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

Pomeroy serves **27 tools**. Every one belongs to exactly one app, except a
single free tool that reports your remaining allowance.

An assistant sees all 27 in its tool list whatever your toggles say. What
changes is whether a call gets through: a tool for an app you have switched off
returns a plain refusal naming the switch to flip, and never touches your data.

## The ten apps

<CardGroup cols={2}>
  <Card title="Calendar" icon="calendar" href="/docs/apps/calendar">
    5 tools · read your schedule, create and change events
  </Card>

  <Card title="Reminders" icon="list-check" href="/docs/apps/reminders">
    3 tools · list, create, complete
  </Card>

  <Card title="Contacts" icon="address-book" href="/docs/apps/contacts">
    1 tool · search, and nothing else
  </Card>

  <Card title="Notes" icon="note-sticky" href="/docs/apps/notes">
    3 tools · list, read, create
  </Card>

  <Card title="Mail" icon="envelope" href="/docs/apps/mail">
    6 tools · mailboxes, list, read, search, unread, index
  </Card>

  <Card title="Messages" icon="comment-dots" href="/docs/apps/messages">
    3 tools · conversations, search, read
  </Card>

  <Card title="Maps" icon="map" href="/docs/apps/maps">
    2 tools · places and directions
  </Card>

  <Card title="Weather" icon="cloud-sun" href="/docs/apps/weather">
    2 tools · current conditions and forecast
  </Card>

  <Card title="Location" icon="location-dot" href="/docs/apps/location">
    1 tool · where this Mac is
  </Card>

  <Card title="Shortcuts" icon="wand-magic-sparkles" href="/docs/apps/shortcuts">
    2 tools · list and run what you already built
  </Card>
</CardGroup>

<Card title="Every tool in one table" icon="table-list" href="/docs/apps/tool-reference">
  Names, what each does, and whether it reads or writes.
</Card>

## Read-mostly, and what that means

Pomeroy's tools read and search, create where you would expect it, and stop.

**There is no tool for sending mail.** Not a disabled one, not one behind a
setting. The function does not exist, so no prompt produces it. The same is
true for sending a message, deleting anything in any app, and editing a
contact.

<Columns cols={3}>
  <div>
    **It can create**

    * An event
    * A reminder
    * A note
  </div>

  <div>
    **It can change**

    * An event you name
    * A reminder, to mark it done
  </div>

  <div>
    **It never**

    * Sends mail or a message
    * Deletes anything, anywhere
    * Creates, edits or deletes a contact
    * Edits or moves an existing note
  </div>
</Columns>

The one exception you control yourself is Shortcuts. A shortcut you built can do
things Pomeroy will not do, including sending a message. That power is yours,
set up in the Shortcuts app; Pomeroy only starts the shortcut you name.

## What an action means

An **action** is one raw tool call: one mail search, one look at your calendar,
one reminder added. That is the unit the free weekly allowance counts.

Asking about your allowance is free, because the status tool never counts
against it.

[How the allowance works](/docs/licence/free-allowance)

## How Pomeroy reaches each app

Only through a **published interface**, the automation surface the app itself
offers for the purpose.

| App                    | Through                          |
| ---------------------- | -------------------------------- |
| Calendar, Reminders    | EventKit                         |
| Contacts               | The Contacts framework           |
| Mail, Notes, Shortcuts | Apple events                     |
| Maps                   | MapKit                           |
| Weather                | WeatherKit                       |
| Location               | Core Location                    |
| Messages               | One read-only file you hand over |

It never reads your screen, never reads another app's interface, and never posts
synthetic clicks or keystrokes. An app with no published interface is an app
Pomeroy cannot reach, unless you build a Shortcut for it.

[What Pomeroy asks macOS for](/docs/privacy/what-pomeroy-asks-macos-for)