Manually Connect to the Domo Essentials MCP Server

Intro

This article explains how to manually connect to the Domo Essentials MCP Server using Claude Desktop, Claude Code, or VS Code.

Prerequisites

Before connecting, ensure you have the following:

Node.js version 21 or higher installed. Use 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 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 for instructions.

Access Tokens management page in Domo Admin settings

Step 2: Install mcp-remote

Open a terminal and run:

npm install mcp-remote

Step 3: Install Claude Desktop

Download and install Claude Desktop.

Claude Desktop application download page

Step 4: Edit the Claude Desktop configuration

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

Claude Desktop Settings Developer tab showing Edit Config option

This opens the configuration file located at:

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

Claude Desktop configuration file open in a text editor

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:

Note: If this is your first manual connection, paste the following right after the first opening brace {. If you have other manual connections, paste the contents of the mcpServers property (second example block).

  "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>"
      ]
    }
  }

    "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.

Step 7: Verify the connection

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

Note: Connectors have moved to Customize. Head there to browse, connect, and manage them.

Claude Desktop Customize panel showing the connected Domo MCP server

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

DomoSqlQueryTool
FileSetQueryTool
SearchTool

Domo MCP server tool permissions list in Claude Desktop

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

Claude Desktop responding to a test query about Domo DataSets

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 domo-mcp \
  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:

{
  "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

Open the Command Palette with Cmd+Shift+P (Mac) or Ctrl+Shift+P (Windows/Linux).
Choose your configuration scope:
- For a global (user) configuration (recommended) available across all workspaces, search for and select MCP: Open User Configuration.
- For a workspace-specific configuration (not recommended for security, as it may expose your credentials), search for and select MCP: Open Workspace Folder MCP Configuration. This creates or opens .vscode/mcp.json.
- For a WSL configuration, search for and select MCP: Open Remote User MCP Configuration. This creates or opens ~/.vscode-server/data/User/mcp.json.

Add the following entry for domo-mcp to the servers object and domo-access-token to the inputs array in the configuration file. Replace <DOMO_DOMAIN> with your Domo instance domain. You’ll be prompted to enter your Access Token when you start the server:

{
  "servers": {
    "domo-mcp": {
      "url": "https://<DOMO_DOMAIN>/api/ai/v1/assistant/mcp/toolkits/DOMO_BASIC_MCP",
      "type": "http",
      "headers": {
        "X-DOMO-DEVELOPER-TOKEN": "${input:domo-access-token}"
      }
    }
  },
  "inputs": [
    {
      "id": "domo-access-token",
      "type": "promptString",
      "description": "Domo Access Token",
      "password": true
    }
  ]
}

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:

"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, for example:

"command": "C:\\Program Files\\nodejs\\npx.cmd"

FAQ

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.

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 dashboard summarization are coming soon.

I connected successfully, but I get an error when I query data.

Your Domo account must have the following grants enabled: Use AI Chat and Use AI Services.

Getting Started

Domo Free

Connect & Integrate

Transform & Manage

Visualize & Interact

AI & Data Science

Automate

Distribute

Admin

General Information

Manually Connect to the Domo Essentials MCP Server

Intro

Prerequisites

Connect Claude Desktop

Step 1: Provision an Access Token

Step 2: Install mcp-remote

Step 3: Install Claude Desktop

Step 4: Edit the Claude Desktop configuration

Step 5: Add the Domo MCP Server configuration

Step 6: Restart Claude Desktop

Step 7: Verify the connection

Connect Claude Code

Connect VS Code

Troubleshoot

FAQ

​Intro

​Prerequisites

​Connect Claude Desktop

​Step 1: Provision an Access Token

​Step 2: Install mcp-remote

​Step 3: Install Claude Desktop

​Step 4: Edit the Claude Desktop configuration

​Step 5: Add the Domo MCP Server configuration

​Step 6: Restart Claude Desktop

​Step 7: Verify the connection

​Connect Claude Code

​Connect VS Code

​Troubleshoot

​FAQ

Intro

Prerequisites

Connect Claude Desktop

Step 1: Provision an Access Token

Step 2: Install mcp-remote

Step 3: Install Claude Desktop

Step 4: Edit the Claude Desktop configuration

Step 5: Add the Domo MCP Server configuration

Step 6: Restart Claude Desktop

Step 7: Verify the connection

Connect Claude Code

Connect VS Code

Troubleshoot

FAQ