celigo-mcp

A Model Context Protocol (MCP) server for Celigo integrator.io. Gives Claude, Cursor, and other MCP clients read-only access to your Celigo account — integrations, flows, connections, exports, imports, and error logs.

Installation

Claude Desktop (quickest)

Add to claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "celigo": {
      "command": "npx",
      "args": ["-y", "celigo-mcp"],
      "env": {
        "CELIGO_API_TOKEN": "your_api_token_here",
        "CELIGO_REGION": "NA"
      }
    }
  }
}

Restart Claude Desktop. Done.

Local install

npm install -g celigo-mcp

Then in your MCP client config:

{
  "mcpServers": {
    "celigo": {
      "command": "celigo-mcp",
      "env": {
        "CELIGO_API_TOKEN": "your_api_token_here",
        "CELIGO_REGION": "NA"
      }
    }
  }
}

Getting your API token

1. Log in to integrator.io
2. Go to Resources (left nav) → API tokens
3. Click Create API token
4. Copy the token — you won't see it again

Configuration

| Environment Variable | Required | Default | Description | |---------------------|----------|---------|-------------| | CELIGO_API_TOKEN | Yes | — | Your Celigo API token | | CELIGO_REGION | No | NA | NA (North America) or EU (Europe) |

Available Tools

| Tool | Description | |------|-------------| | celigo_validate_token | Confirm authentication is working | | celigo_list_integrations | List all integrations | | celigo_get_integration | Get full details for a single integration | | celigo_list_flows | List flows (optionally filtered by integration) | | celigo_get_flow | Get full flow configuration | | celigo_get_flow_jobs | Get recent job run history for a flow | | celigo_list_connections | List all connections and their online status | | celigo_get_connection | Get full connection details | | celigo_list_exports | List export configurations | | celigo_get_export | Get full export config including hooks and scripts | | celigo_list_imports | List import configurations | | celigo_get_import | Get full import config including field mappings | | celigo_get_flow_errors | Get open errors for a flow (full raw JSON payloads) | | celigo_get_job_errors | Get errors for a specific job run |

Example prompts

"Are any of my Celigo connections currently offline?"
"Show me all flows in the NetSuite integration"
"What errors does the order sync flow have?"
"When did the customer sync last run and how many records failed?"
"Show me the full config for this export including any scripts"

Development

git clone https://github.com/accentra-australia/celigo-mcp.git
cd celigo-mcp
npm install
npm run build
npm start

Contributing

Issues and PRs welcome at github.com/accentra-australia/celigo-mcp.

License

MIT