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

# Connect Pomeroy to Cherry Studio

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

**Cherry Studio** is a desktop client for any model, and it works with Pomeroy.
Pomeroy sets itself up in it with one click. Cherry Studio can then read the
apps you switched on, and no others.

<Info>
  **What Set up does.** Pomeroy opens Cherry Studio's install link and Cherry
  Studio shows the command it is about to add, with **Cancel** and **Install**.
  Nothing is written until you accept.
</Info>

## Set up

<Steps>
  <Step title="Install Pomeroy and switch on your apps">
    [Download Pomeroy](https://pomeroy.app/download), drag it into Applications
    and open it. Switch on the apps you want Cherry Studio to reach. Everything
    starts off, and macOS asks you to approve each app as you switch it on. [The
    full walkthrough](/docs/getting-started/installation).
  </Step>

  <Step title="Install Cherry Studio, if you have not">
    Pomeroy lists the assistants it finds on this Mac, so install [Cherry
    Studio](https://github.com/CherryHQ/cherry-studio/releases) first if it is
    not there. Returning to Pomeroy's window re-checks.
  </Step>

  <Step title="Press Set up">
    In Pomeroy's **Assistants** pane, find Cherry Studio and press **Set up**.
    It is safe to press any number of times. It writes the same thing every
    time, and it never disturbs another server already there.
  </Step>

  <Step title="Pick it up">
    **You may need to restart Cherry Studio.** It picks the change up on its own
    in most versions; if the tools are missing, restart it.
  </Step>

  <Step title="Ask something">
    In Cherry Studio, ask what is on your calendar today. The answer comes from
    your Mac.
  </Step>
</Steps>

## The configuration

You do not need this. **Set up** writes it for you. It is here so you can see
what Pomeroy adds, check it by hand, or set up a second Mac without opening the
panel.

Goes in **Cherry Studio › Settings › MCP Server › Add Server › Import from JSON**:

```json theme={null}
{
  "mcpServers": {
    "pomeroy": {
      "command": "/Applications/Pomeroy.app/Contents/MacOS/pomeroy-mcp"
    }
  }
}
```

The command is a single absolute path with no arguments, and it lives inside
Pomeroy's app bundle, so an update never changes it. [What the pipe
is](/docs/configuration/stdio).

## Over the local endpoint

Cherry Studio can also reach Pomeroy over the [HTTP
endpoint](/docs/configuration/http-endpoint) instead of the pipe. Use it only for a
copy running somewhere that cannot start a program on this Mac, such as a
container or a remote workspace. Switch the local address on in Pomeroy's
**Connections** pane first.

Goes in **Cherry Studio › Settings › MCP Server › Add Server › Import from JSON**:

```json theme={null}
{
  "mcpServers": {
    "pomeroy": {
      "baseUrl": "http://127.0.0.1:13579/mcp",
      "headers": {
        "Authorization": "Bearer <the key Pomeroy generates>"
      },
      "type": "streamableHttp"
    }
  }
}
```

Pomeroy writes the real token in place of the placeholder when it can reach this
assistant's settings. Otherwise you can read the token under **Connections**.

## How to check it worked

In Cherry Studio, **Settings › MCP Server** lists `pomeroy`. Switch it on, then
ask a new chat what tools it has.

If the tools are missing, the cause is almost always that the assistant has not
re-read its server list.
[Troubleshooting](/docs/getting-started/troubleshooting#an-assistant-cannot-see-the-tools).

## Worth knowing about Cherry Studio

Cherry Studio asks twice: once to install the server, and again before it will
run a server that arrived from outside the app. Both prompts are Cherry Studio's
own.

## What it can reach

Only the apps you switched on, and only through the tools Pomeroy publishes.
Cherry Studio cannot send mail, send a message, delete anything or edit a
contact, because no tool does those things.

<CardGroup cols={2}>
  <Card title="What Pomeroy can do" icon="grid-2" href="/docs/features/overview">
    Ten apps, 27 tools, and every refusal.
  </Card>

  <Card title="Permissions" icon="toggle-on" href="/docs/getting-started/permissions">
    What each toggle grants, and what macOS asks you for.
  </Card>

  <Card title="Other assistants" icon="plug" href="/docs/assistants/overview">
    All 24, and what to do if yours is not listed.
  </Card>

  <Card title="Connect Pomeroy to Cherry Studio" icon="link" href="https://pomeroy.app/connect/cherry-studio">
    The product page for Cherry Studio, with what it costs.
  </Card>
</CardGroup>