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

# Loops MCP server

> Connect the Loops MCP server to AI tools like ChatGPT and Claude to manage contacts, events, and transactional email.

The Loops [MCP](https://modelcontextprotocol.io) server lets AI tools like ChatGPT and Claude work with your Loops account.

## What you can do

Use your AI tool to work with the [Loops API](/docs/api-reference/intro), including:

* **Contacts**: find, create, and update contacts and their properties.
* **Mailing lists**: check membership and add or remove contacts.
* **Events**: send events that update contact activity or start published workflows.
* **Transactional email**: send a published transactional email with data variables.
* **Campaigns, workflows, and email content**: create and manage campaigns and workflows, and edit email content.

## Amp

Amp CLI does not support the MCP server yet. You can install via the web or desktop app first to access it in the CLI.

<Steps>
  <Step title="Add the Loops MCP server">
    In the Amp web or desktop app, go to [MCP server settings](https://ampcode.com/settings/mcp-servers) and click **+ Add MCP Server**. Enter the URL `https://mcp.loops.so`, and click **Connect**.
  </Step>

  <Step title="Authenticate">
    Follow the prompt to sign in to Loops in your browser.
  </Step>

  <Step title="Test the connection">
    Ask Amp something like *"Which Loops teams am I a part of?"* to confirm it can reach your account.
  </Step>
</Steps>

## ChatGPT

<Steps>
  <Step title="Add the Loops plugin">
    Go to Plugins and search for Loops or use this direct link:

    * [Loops plugin (web)](https://chatgpt.com/plugins/plugin_asdk_app_6a76060a3cbc81919eaaca7e37e830fe)
    * [Loops plugin (desktop)](https://chatgpt.com/plugins/plugin_asdk_app_6a76060a3cbc81919eaaca7e37e830fe?open_in_app)
  </Step>

  <Step title="Authenticate">
    Click **Install plugin** and follow the prompt to sign in to Loops in your browser.
  </Step>

  <Step title="Test the connection">
    Ask ChatGPT something like *"Which Loops teams am I a part of?"* to confirm it can reach your account.
  </Step>
</Steps>

## Claude Code CLI

<Steps>
  <Step title="Add the Loops MCP server">
    ```bash theme={"dark"}
    claude mcp add loops https://mcp.loops.so --scope user --transport http
    ```
  </Step>

  <Step title="Authenticate">
    Run `/mcp` inside Claude Code and follow the prompt to sign in to Loops in your browser.
  </Step>

  <Step title="Test the connection">
    Ask Claude something like *"Which Loops teams am I a part of?"* to confirm it can reach your account.
  </Step>
</Steps>

## Claude

<Steps>
  <Step title="Open connector settings">
    In Claude, go to **Settings → Connectors** and click **Browse connectors**.
  </Step>

  <Step title="Add the Loops MCP server">
    Search for "Loops" and click the `+` button to the right. Click the **Connect** or **Add to your team** button.
  </Step>

  <Step title="Authenticate">
    Open the connector and follow the prompt to sign in to Loops in your browser.
  </Step>

  <Step title="Test the connection">
    Ask Claude something like *"Which Loops teams am I a part of?"* to confirm it can reach your account.
  </Step>
</Steps>

## Codex CLI

Make sure to update to Codex CLI v1.48.0 or later.

<Steps>
  <Step title="Add the Loops MCP server">
    ```bash theme={"dark"}
    codex mcp add loops --url https://mcp.loops.so
    ```
  </Step>

  <Step title="Authenticate">
    Follow the prompt to sign in to Loops in your browser.
  </Step>

  <Step title="Test the connection">
    In Codex CLI, ask something like *"Which Loops teams am I a part of?"* to confirm it can reach your account.
  </Step>
</Steps>

## OpenCode

Make sure to update to OpenCode v2.0.4 or later.

<Steps>
  <Step title="Add the Loops MCP server">
    ```bash theme={"dark"}
    opencode mcp add loops --url https://mcp.loops.so
    ```
  </Step>

  <Step title="Authenticate">
    ```bash theme={"dark"}
    opencode mcp auth loops
    ```

    Follow the prompt to sign in to Loops in your browser.
  </Step>

  <Step title="Test the connection">
    Ask OpenCode something like *"Which Loops teams am I a part of?"* to confirm it can reach your account.
  </Step>
</Steps>

## Other MCP clients

Add `https://mcp.loops.so` as a remote Streamable HTTP MCP server. Your client must support OAuth using Client ID Metadata Documents (CIMD). The configuration format depends on your client.

For VS Code 1.106 or later, add this to `.vscode/mcp.json` in your project:

```json theme={"dark"}
{
  "servers": {
    "loops": {
      "type": "http",
      "url": "https://mcp.loops.so"
    }
  }
}
```

Follow your client's authentication prompt to sign in to Loops in your browser and authorize access.


## Related topics

- [Agent skills for Loops](/docs/skills.md)
- [Loops SDKs](/docs/sdks.md)
- [Quickstart for agents](/docs/quickstart-agents.md)
- [Loops CLI](/docs/cli.md)
- [Better Auth](/docs/integrations/better-auth.md)