> ## Documentation Index
> Fetch the complete documentation index at: https://domoinc-openapi-sync-dataflows.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect AI Tools to Domo Using MCP (Beta)

## Intro

<Note>
  **Note:** This feature is in beta. Contact your Domo account team to join.
</Note>

The Model Context Protocol (MCP) is an open standard that allows AI assistants to securely interact with external platforms and data sources. Domo's MCP Server is a hosted service that gives AI tools — such as Claude, Cursor, VS Code, and ChatGPT — secure access to your Domo instance.

After you're connected, you can use your AI tool to:

* Query data in your Domo DataSets
* Query documents stored in Domo
* Search across your Domo instance
* Summarize cards and pages (coming soon)

This article walks through how to connect Claude Desktop, Claude Code, or VS Code to the Domo MCP Server and verify your connection.

<Frame>
  <img src="https://mintcdn.com/domoinc-openapi-sync-dataflows/xwNSEyWVTyoQ8Uac/images/kb/DOMO-MCP-Server-Screenshot-1.png?fit=max&auto=format&n=xwNSEyWVTyoQ8Uac&q=85&s=6bd37de608c888217bc066bbc861dab7" alt="" width="1340" height="804" data-path="images/kb/DOMO-MCP-Server-Screenshot-1.png" />
</Frame>

***

## Prerequisites

Before connecting, ensure you have the following:

* **Node.js** version 21 or higher installed. Use [nvm](https://github.com/nvm-sh/nvm) to manage your Node.js version.
* A Domo **Access Token** with appropriate permissions. You can provision one at **Admin** > **Authentication** > **Access Tokens**, or request one from your MajorDomo. See [Manage Access Tokens](/s/article/360042934494#manage-access-tokens) for instructions.
* A supported AI code editor (Claude Desktop, Claude Code, VS Code, Cursor, or another MCP-compatible client).

## Connect Claude Desktop

Claude Desktop does not natively support remote MCP servers, so you connect using `mcp-remote` — an NPM tool that bridges desktop AI clients to remote MCP servers.

### Step 1: Provision an Access Token

In your Domo instance, go to **Admin** > **Authentication** > **Access Tokens** and generate a token. See [Manage Access Tokens](/s/article/360042934494#manage-access-tokens) for instructions.

<Frame>
  <img src="https://mintcdn.com/domoinc-openapi-sync-dataflows/xwNSEyWVTyoQ8Uac/images/kb/DOMO-MCP-Server-Screenshot-2.png?fit=max&auto=format&n=xwNSEyWVTyoQ8Uac&q=85&s=8997df0c117f4a5ffaed5969aed03d00" alt="" width="2210" height="172" data-path="images/kb/DOMO-MCP-Server-Screenshot-2.png" />
</Frame>

### Step 2: Install mcp-remote

Open a terminal and run:

```
npm install mcp-remote
```

### Step 3: Install Claude Desktop

Download and install [Claude Desktop](https://claude.ai/download).

<Frame>
  <img src="https://mintcdn.com/domoinc-openapi-sync-dataflows/xwNSEyWVTyoQ8Uac/images/kb/DOMO-MCP-Server-Screenshot-3.png?fit=max&auto=format&n=xwNSEyWVTyoQ8Uac&q=85&s=245932bdc7102a5254c0e211f80d96b0" alt="" width="1196" height="1094" data-path="images/kb/DOMO-MCP-Server-Screenshot-3.png" />
</Frame>

### Step 4: Edit the Claude Desktop configuration

In Claude Desktop, go to **Settings** > **Developer** and select **Edit Config**.

<Frame>
  <img src="https://mintcdn.com/domoinc-openapi-sync-dataflows/xwNSEyWVTyoQ8Uac/images/kb/DOMO-MCP-Server-Screenshot-4.png?fit=max&auto=format&n=xwNSEyWVTyoQ8Uac&q=85&s=ce7302301421474c5791472a22962b70" alt="" width="1196" height="1094" data-path="images/kb/DOMO-MCP-Server-Screenshot-4.png" />
</Frame>

This opens the configuration file located at:

```
/Users/<username>/Library/Application Support/Claude/claude_desktop_config.json
```

<Frame>
  <img src="https://mintcdn.com/domoinc-openapi-sync-dataflows/xwNSEyWVTyoQ8Uac/images/kb/DOMO-MCP-Server-Screenshot-5.png?fit=max&auto=format&n=xwNSEyWVTyoQ8Uac&q=85&s=68a06283dc78725a2bc4f6d0502b5ca8" alt="" width="1196" height="1094" data-path="images/kb/DOMO-MCP-Server-Screenshot-5.png" />
</Frame>

### Step 5: Add the Domo MCP Server configuration

Paste the following into the configuration file, replacing `<DOMO_DOMAIN>` with your Domo instance domain and `<DOMO_ACCESS_TOKEN>` with your Access Token:

```json theme={"dark"}
{
  "mcpServers": {
    "domo-mcp-npx": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://<DOMO_DOMAIN>/api/ai/v1/assistant/mcp/toolkits/DOMO_BASIC_MCP",
        "--header",
        "X-DOMO-DEVELOPER-TOKEN:<DOMO_ACCESS_TOKEN>"
      ]
    }
  }
}
```

### Step 6: Restart Claude Desktop

Quit and restart Claude Desktop for the configuration to take effect.

<Frame>
  <img src="https://mintcdn.com/domoinc-openapi-sync-dataflows/xwNSEyWVTyoQ8Uac/images/kb/DOMO-MCP-Server-Screenshot-6.png?fit=max&auto=format&n=xwNSEyWVTyoQ8Uac&q=85&s=0614441c7e2068efb287ada9c0c41f01" alt="" width="1196" height="1094" data-path="images/kb/DOMO-MCP-Server-Screenshot-6.png" />
</Frame>

### Step 7: Verify the connection

Go to **Settings** > **Connectors** and confirm the Domo MCP server is listed and connected.

<Frame>
  <img src="https://mintcdn.com/domoinc-openapi-sync-dataflows/xwNSEyWVTyoQ8Uac/images/kb/DOMO-MCP-Server-Screenshot-7.png?fit=max&auto=format&n=xwNSEyWVTyoQ8Uac&q=85&s=65bcece5529814f2711760e73f77d3c5" alt="" width="1196" height="1094" data-path="images/kb/DOMO-MCP-Server-Screenshot-7.png" />
</Frame>

Select the server to view its tool permissions. You should see the following tools listed:

* `DomoSqlQueryTool`
* `ExtendedThinkingTool`
* `FileSetQueryTool`
* `SearchTool`

<Frame>
  <img src="https://mintcdn.com/domoinc-openapi-sync-dataflows/xwNSEyWVTyoQ8Uac/images/kb/DOMO-MCP-Server-Screenshot-8.png?fit=max&auto=format&n=xwNSEyWVTyoQ8Uac&q=85&s=ffaaaff66e0ff4433f2af191b5ccd665" alt="" width="1196" height="1094" data-path="images/kb/DOMO-MCP-Server-Screenshot-8.png" />
</Frame>

To test the connection, try a prompt such as: "How many datasets do I have access to?"

<Frame>
  <img src="https://mintcdn.com/domoinc-openapi-sync-dataflows/xwNSEyWVTyoQ8Uac/images/kb/DOMO-MCP-Server-Screenshot-9.png?fit=max&auto=format&n=xwNSEyWVTyoQ8Uac&q=85&s=1deb1b7ee5ecf609c19b330830b6fd8a" alt="" width="1196" height="1094" data-path="images/kb/DOMO-MCP-Server-Screenshot-9.png" />
</Frame>

## Connect Claude Code

In Claude Code, run the following command from the root of your project. Replace `<DOMO_DOMAIN>` with your Domo instance domain and `<DOMO_ACCESS_TOKEN>` with your Access Token:

```
claude mcp add --transport http secure-api \
  https://<DOMO_DOMAIN>/api/ai/v1/assistant/mcp/toolkits/DOMO_BASIC_MCP \
  --header "X-DOMO-DEVELOPER-TOKEN: <DOMO_ACCESS_TOKEN>"
```

This adds the configuration to a `.mcp` file in the root of your project:

```json theme={"dark"}
{
  "mcpServers": {
    "domo-mcp": {
      "type": "http",
      "url": "https://<DOMO_DOMAIN>/api/ai/v1/assistant/mcp/toolkits/DOMO_BASIC_MCP",
      "headers": {
        "X-DOMO-DEVELOPER-TOKEN": "<DOMO_ACCESS_TOKEN>"
      }
    }
  }
}
```

## Connect VS Code

1. Open the Command Palette with **Cmd+Shift+P** (Mac) or **Ctrl+Shift+P** (Windows/Linux).

2. Choose your configuration scope:
   * For a **global configuration** available across all workspaces, search for and select **MCP: Open User Configuration**.
   * For a **workspace-specific configuration** (recommended for sharing within a project), search for and select **MCP: Open Workspace Folder MCP Configuration**. This creates or opens `.vscode/mcp.json`.

3. Add the following entry to the `servers` object in the configuration file. Replace `<DOMO_DOMAIN>` with your Domo instance domain and `<DOMO_ACCESS_TOKEN>` with your Access Token:

   ```json theme={"dark"}
   {
     "servers": {
       "domo-mcp": {
         "type": "http",
         "uri": "https://<DOMO_DOMAIN>/api/ai/v1/assistant/mcp/toolkits/DOMO_BASIC_MCP",
         "headers": {
           "X-DOMO-DEVELOPER-TOKEN": "<DOMO_ACCESS_TOKEN>"
         },
         "version": "1.0.0"
       }
     }
   }
   ```

## Troubleshoot

Depending on your environment, you may need to make additional changes to the Claude Desktop configuration.

**Mac**

If `npx` cannot be found, add an `env` property to the `domo-mcp-npx` server entry in your configuration, replacing `<USER_PATH>` with your home directory path:

```json theme={"dark"}
"env": {
  "PATH": "<USER_PATH>/.nvm/versions/node/v22.21.1/bin:/usr/local/bin:/usr/bin:/bin"
}
```

**Windows**

If `npx` cannot be found, replace the `"command"` value in your configuration with the full path to the `npx` executable:

```json theme={"dark"}
"command": "C:\\Program Files\\nodejs\\npx.cmd"
```

## FAQ

<AccordionGroup>
  <Accordion title="Which AI tools are compatible with the Domo MCP Server?">
    The Domo MCP Server works with any MCP-compatible AI client, including Claude Desktop, Claude Code, VS Code, Cursor, and ChatGPT.
  </Accordion>

  <Accordion title="What can I do after I'm connected?">
    After you're connected, you can query your Domo DataSets, query documents stored in Domo, and search across your Domo instance. Card and page summarization are coming soon.
  </Accordion>
</AccordionGroup>