# Connect Claude to Emm AI

This page is for a person connecting **Claude** (claude.ai, Claude Desktop,
or Claude Code) to their **Emm AI** account. If you'd rather have your AI
walk you through it — Claude included — paste this into it: *"Help me set up
Emm using https://ai.actingweb.io/setup"*.

## The facts

- MCP server URL: **`https://ai.actingweb.io/mcp`**
- Leave **Client ID** and **Client Secret** blank — the server registers
  itself automatically; a browser sign-in is all it takes.
- Sign in with **Google, GitHub, or Apple.**
- When you sign in, you'll be asked to choose an **access level**:
  - **Read-only** — Claude can search and retrieve your Emm data, but never
    create, change, or delete anything.
  - **Read/Write** (the default) — full access: Claude can also save,
    update, and delete memories and other content on your behalf.
  Read-only refuses every write outright; pick it if you want Claude to look
  things up but never change anything, and switch to Read/Write later when
  you want it to save for you. Asking before it reads anything shared by
  another person, or before it runs a remote action, is part of the guidance
  Claude is given, not something the server enforces per access level.

## claude.ai (browser)

1. Open **Settings → Customize → Connectors**.
2. Click **Add**, choose **Add custom connector**.
3. Paste `https://ai.actingweb.io/mcp` as the MCP server URL, give it a name
   (anything you like — "Emm" is a good default), and choose **Sign in now**.
4. Pick your access level, then sign in with Google, GitHub, or Apple.
5. Back in Claude, ask it to check your Emm status to confirm it's connected,
   then try one of these (the last two need a Read/Write connection and
   mission control, which is on for new accounts):
   - "What is known about my preferences from Emm?"
   - "Start a plan for my next trip in Emm that I can keep working on." (Read/Write)
   - "Is there anything you should be doing for me?" (Read/Write)

## Claude Desktop

The desktop app hosts Chat, Workspace, and Claude Code in one place. Open
**Customize** in the sidebar and follow the same steps as claude.ai above —
Workspace and Code share the same connector list as Chat.

## Claude Code

Run this in a terminal:

```
claude mcp add --transport http emm https://ai.actingweb.io/mcp --scope user
```

Then start (or continue) a session and run `/mcp` to sign in.

## Install the skill or plugin (recommended, any surface above)

Emm AI ships a skill that teaches Claude when to search Emm, how to save
memories, and which tools exist. Downloading and installing it is a separate
step from connecting above — do both. The skill and plugin downloads are on
the Help page inside the app (after you sign in), or ask Claude to fetch and
install them for you once it's connected.

## Troubleshooting

- **No Connect card, or the connector shows disconnected.** Re-check the URL
  is exactly `https://ai.actingweb.io/mcp` and that Client ID/Secret were
  left blank.
- **"Couldn't reach the server" or a timeout.** Try again in a minute — this
  usually means a transient network issue, not a configuration problem.
- **Connected, but Claude says it has no Emm tools.** Start a fresh
  conversation — some clients only pick up a newly connected server on the
  next session.
- **Need to change your access level later?** Remove the connector and
  re-add it, choosing the other access level when you sign in again.

Questions, or something on this page doesn't match what you see:
**<support@actingweb.io>**