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

# Integrations from your AI app

> Run your Integrations flows from Claude, Claude Code, Cursor or Codex by asking for them in the chat.

Your Integrations flows already move call results into your CRM, sheets and chat apps. Once your AI app is connected to Topcalls, you can also run those flows from the chat.

You need two things first:

* An AI app connected to Topcalls. See [Connect your AI app](https://docs.topcalls.ai/mcp/connect.md).
* Integrations switched on for your account. Open **Integrations** in the left sidebar of Topcalls. If it isn't on yet, the AI app tells you so when you ask for a flow.

To run a flow, your role has to allow managing Integrations. Owners and members can by default. A member who can only view Integrations can list flows but can't run them.

## Run a flow you already have

Two tools do this: `list_integration_flows` and `run_integration_flow`.

**1. Ask what's there**

Ask something like "Which Integrations flows can I run?" The app lists the flows of your Integrations that can run as tools, each with a name and a short description.

**2. Ask for the run**

For example: "Run the flow that adds a contact to Pipedrive for Maria Ionescu, [maria@example.com](mailto:maria@example.com)." The app fills in the fields the flow expects and runs it.

**3. Read the answer**

The flow's answer comes back in the chat. If the flow reports an error, the app sees it as an error, not as a success.

A run is real. It acts in your connected apps with your account's Integrations login, so it can create, change or delete data there. Topcalls marks `run_integration_flow` as not undoable, which lets apps like Claude ask you before each run. Whether the app asks is up to the app.

## Who sees which tools

* **Read-only connection:** `list_integration_flows` only. It can't run a flow.
* **ChatGPT:** neither of the two Integrations tools.
* **Every other MCP app** (Claude, Claude Code, Cursor, Codex and others): both tools, within what your role allows.

## What stays with you

The AI app does what you ask, so check which flow it's about to run and with which values before you say yes.

Your flows stay on the **Integrations** page in Topcalls, where you can open and change them yourself. You can end your AI app's connection at any time on the **CLI & MCP** page. See [Security and limits](https://docs.topcalls.ai/mcp/security.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.