> ## Documentation Index
> Fetch the complete documentation index at: https://docs.helloleo.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# HelloLeo MCP

> Give Leo access to your other projects, and build HelloLeo from Claude, Cursor or any MCP client

HelloLeo MCP works in two directions, and it helps to keep them apart.

**Inside HelloLeo**, enabling it lets Leo (and your agents) reach your *other* projects: list them, read and edit their files, check their preview status and runtime errors, or look at what they are connected to. Useful when a new project should reuse a component you already built, or when the same change has to land on several projects.

**From outside HelloLeo**, it turns your account into a remote MCP server. Connect it to Claude, Claude Code, Cursor or any MCP client and that assistant can create projects, write code, deploy previews and query your connected tools (Odoo and the rest), using your HelloLeo account.

## Use it inside HelloLeo

<Steps>
  <Step title="Enable the integration">
    Open **Project Settings** → **Project Integrations**, pick **HelloLeo MCP** and save. There is nothing to fill in: HelloLeo issues the access for you.
  </Step>

  <Step title="Ask Leo about your other projects">
    *"List my projects and tell me which ones already have an Odoo connection."*
  </Step>

  <Step title="Reuse what you built">
    *"Copy the invoice table component from my Client Portal project into this one."*
  </Step>
</Steps>

Agents work the same way. Enable HelloLeo MCP on an agent and it can read and modify the projects its workspace gives it access to.

## Use it from your AI client

<Info>
  Connecting an external AI client requires a plan that includes HelloLeo MCP (Leo Business and above). Enabling the integration inside HelloLeo works on every plan.
</Info>

The server URL is:

```
https://mcp.helloleo.dev/mcp
```

You never paste a token anywhere. On first use the client opens a HelloLeo sign-in page, you approve the access, and the connection is bound to your account from then on.

### Claude (web and desktop)

<Steps>
  <Step title="Add the connector">
    **Settings** → **Connectors** → **Add custom connector**, paste the URL above.
  </Step>

  <Step title="Connect">
    Click **Connect**. Your browser opens the HelloLeo consent screen, approve it.
  </Step>

  <Step title="Use it in a conversation">
    Enable the connector in the chat, then try *"List my HelloLeo projects."*
  </Step>
</Steps>

### Claude Code

```bash theme={null}
claude mcp add --transport http helloleo https://mcp.helloleo.dev/mcp
```

The first tool call triggers the browser sign-in.

### Cursor and other MCP clients

Add a remote MCP server (streamable HTTP transport) pointing at the URL above. Any client that supports remote MCP servers with OAuth will work the same way.

## What the assistant can do

| Tool                                      | What it does                                                                 |
| ----------------------------------------- | ---------------------------------------------------------------------------- |
| `list_projects`                           | Your projects, paginated and searchable                                      |
| `get_project`                             | One project: preview URL, deploy status, integrations, recent runtime errors |
| `create_project`                          | A new project, blank or from a template                                      |
| `deploy_project`                          | Start or wake the preview sandbox                                            |
| `list_dir`, `read_file`, `glob`, `grep`   | Explore a project's code                                                     |
| `write_file`, `edit_file`                 | Change code (committed, and synced to the live preview)                      |
| `list_chat_messages`                      | The project's chat history with Leo, to understand what was asked and why    |
| `get_project_analytics`                   | Real usage: visitors, pageviews, sessions, top pages                         |
| `list_connections`, `connect_integration` | Attach one of your saved integrations to a project                           |
| `odoo_execute_method`                     | Query or write to an Odoo connected to that project                          |

## What it can and cannot reach

Every call is checked against your own permissions, on our side, not the client's. An assistant connected to your account sees exactly the projects you see: the ones you own, plus those shared through a workspace you belong to. Anything else answers "not found".

A few things are deliberately out of reach, whatever the assistant asks for: environment files and secrets, the internal git directory, and HelloLeo's own internal files. Requests are also rate limited, so a runaway loop cannot hammer your projects.

## Troubleshooting

**The client says the server is unauthorized.** Sign in to [app.helloleo.dev](https://app.helloleo.dev) in the same browser, then reconnect. The consent screen needs an active HelloLeo session.

**Connecting fails and your plan is below Business.** External clients are gated by plan. Enable the integration inside HelloLeo instead, or upgrade.

**A newly created project has no files.** A blank project starts empty: ask the assistant to write its first file, then to deploy it. Preview URLs only appear once the sandbox has booted.

**Analytics come back empty.** A project only has analytics once it has been previewed or published, and only page-level traffic is measured. Individual clicks are not tracked.