Guide

Connect AI Apps

Let Claude, Codex, Gemini and other AI apps on your Mac find, save and organise your library. It takes a minute to set up, and it's off until you turn it on.

Set Up in a Minute

One setup works for most AI apps.

  1. Update Muse

    MCP Server comes with Muse 1.0.40 and later.

  2. Allow AI Apps

    Switch it on in Settings > Intelligence.

  3. Click Copy Setup

    Muse copies the setup your AI app needs.

  4. Paste the Setup

    Add it to your AI app's MCP settings.

  5. Reopen and Ask

    Your AI app reads the setup when it starts.

Copy Setup gives you this
{
  "mcpServers": {
    "muse": {
      "command": "/Applications/Muse.app/Contents/MacOS/muse-mcp"
    }
  }
}

Actions

The same actions as Muse itself, on your own library.

Find and Look

  • Search by words, colours and text in pictures.
  • Browse the Inbox, favourites, collections and tags.
  • Look at your pictures, and find similar ones.
  • Read an item's note, tags and where it came from.
  • Open what it found in Muse.

Save and Organise

  • Save links, pictures, videos, files and notes.
  • Rename items, write notes and add tags.
  • File items into collections.
  • Create, rename and move collections.
  • Move items to the Trash, and put them back.

Only you can empty the Trash.

Things to Ask

Once it's connected, just ask.

Scripts and Shortcuts

Your scripts and shortcuts get the same actions as AI apps, through the Local API. Muse needs to be open while they run.

  1. Turn On Allow Scripts

    Open Settings > Intelligence > Local API.

  2. Copy Your Key

    Each request needs your key, which you copy from the same section.

  3. Open API Guide

    API Guide lists every action with examples.

A search from Terminal
curl http://127.0.0.1:17895/v1/search \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "blue chair"}'
AI Apps and Scripts

You're Always
in Control.

Both are off until you turn them on.

Frequently Asked

What is MCP?
MCP is a standard way for AI apps to use other apps on your Mac. Muse includes an MCP server, so an AI app you connect can search your library, look at your pictures and help organise it.
What's the difference between MCP Server and Local API?
They share the same actions. MCP Server is for AI apps: you paste the setup once, then just ask. Local API is for your own scripts and shortcuts, which send requests to Muse with a key you copy from Settings > Intelligence.
Is it on by default?
No. You're always in control: both are off until you choose to turn them on, and your library never leaves your Mac through Muse. Turn them on in Settings > Intelligence, under MCP Server and Local API.
Where do I paste the setup?
In Claude Desktop, open Settings > Developer > Edit Config, paste the setup into the file, save it, then quit and reopen Claude. If the file already lists other servers, add the muse entry alongside them. In Claude Code, paste the setup into a chat and ask Claude to add Muse. Codex keeps its settings in a different format, so for Codex, run this in Terminal instead: codex mcp add muse -- /Applications/Muse.app/Contents/MacOS/muse-mcp In other apps, paste it where the app keeps its MCP settings.
Which AI apps work with Muse?
Claude Desktop, Claude Code, Codex, Gemini, Cursor, Raycast, LM Studio and most other AI apps on your Mac that support MCP servers. Claude on the web and the Claude iPhone app can't connect, because Muse only accepts connections from apps running on your Mac.
Does it work with ChatGPT?
Not yet. ChatGPT can only reach MCP servers on the internet, and Muse only accepts connections from apps running on your Mac. Claude, Codex and Gemini all work today.
Does it cost extra, or need an account?
No. MCP Server and Local API are part of Muse, with no account, no sign-up and no API key. Your AI app's own plan still applies to your chats in it.
Can an AI app delete things from my library?
No. When an AI app or script removes an item or a collection, it goes to Muse's Trash, where you can restore it, and only you can empty the Trash. Before the first change an AI app or script makes each day, Muse also saves a copy of your library and keeps the last seven. You can go back to one from Settings > Library > Backup > Undo AI Changes.
Can websites or other people reach my library through this?
No. Muse only accepts connections from apps running on your own Mac, never from the internet or other devices on your network. Web pages are blocked even when they run on this Mac, and scripts need your key. Both switches are off until you turn them on.
Does my library get sent to the AI company?
Muse only answers the AI app on your Mac, and only when you ask it something. Most AI apps then send your chat, including what Muse found, to their own servers to reply, under that app's own privacy terms. Hidden items are never shared. To keep everything on your Mac, use an app that runs its AI on your Mac, like LM Studio.
Can an AI app see my hidden items?
No. Items you've hidden don't appear in anything AI apps or scripts can see: not in search, collections, the Trash or the library counts. They can't open, change or move them either. To let an AI app use one, unhide it first.
Can an AI app reach other files on my Mac through Muse?
Muse doesn't let an AI app browse your Mac. An AI app can ask Muse to save a file or folder by its location, and it's then copied into your library like anything else you save. The first time Muse opens a file in Desktop, Documents or Downloads, macOS asks for your permission.
How do I stop an AI app or script from using Muse?
Turn off Allow AI Apps in Settings > Intelligence > MCP Server, and every AI app is shut out straight away. For scripts, turn off Allow Scripts. Or choose Make a New Key next to Key: anything still using the old key is shut out, and your own scripts keep working once you give them the new one.
My AI app can't find Muse, or says it disconnected.
Check that Allow AI Apps is on in Settings > Intelligence > MCP Server. After pasting the setup, quit and reopen your AI app, since most only read their MCP settings when they start. If you moved Muse after copying the setup, for example into Applications, click Copy Setup again and replace the old entry, because the setup includes where Muse is.
Do AI apps and scripts work during the free trial?
Yes. Everything works during your 30-day trial. If the trial ends before you buy, AI apps and scripts can still see how big your library is, but searching, saving and organising resume once you add your licence.

Try Muse completely

free.

Free for 30 days, every feature unlocked: no limits, nothing held back.

Download

No credit card needed