Skip to main content

Limble MCP: User Setup Guide

How to Connect Limble's MCP to Cursor, Claude, or Claude Code

Updated over a week ago

Overview

This guide explains how customers can connect to Limble's Official MCP Server. It covers authentication and configuration for popular MCP clients: Cursor, Claude Desktop, and Claude Code.

Table of Contents

Prerequisites

Step 1: Configure Your MCP Client

Step 2: Verify the Connection

Troubleshooting

Prerequisites

  • Download and install Node.js: https://nodejs.org/en/download

  • Hosted MCP endpoint URL, for example:
    ​<https://mcp.limblecmms.com/mcp)>

  • Limble API credentials, provided as:

    • Limble-Client-ID: <id> and Limble-Client-Secret: <secret> headers

    Learn more about managing API keys in this article.

The server handles authentication injection to Limble and applies a consistent User-Agent automatically.

Step 1: Configure Your MCP Client

Cursor IDE

Edit ~/.cursor/mcp.json and add an entry that uses the hosted endpoint via mcp-remote:
​

{
  "mcpServers": {
    "limble-mcp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.limblecmms.com/mcp",
        "--header",
        "Limble-Client-ID: YOUR_CLIENT_ID",
        "--header",
        "Limble-Client-Secret: YOUR_CLIENT_SECRET"
      ]
    }
  }
}

After saving, restart Cursor.

Claude Desktop


Open Claude Desktop → Settings → Developers → Edit Config and add a hosted entry using split headers:

{
  "mcpServers": {
    "limble-mcp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.limblecmms.com/mcp",
        "--header",
        "Limble-Client-ID: YOUR_CLIENT_ID",
        "--header",
        "Limble-Client-Secret: YOUR_CLIENT_SECRET"
      ]
    }
  }
}

After saving, restart Claude Desktop.

Claude Code


Edit or create /YOUR_PROJECT_DIRECTORY/.mcp.json and add an entry that uses the hosted endpoint via mcp-remote:
​

{
  "mcpServers": {
    "limble-mcp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://mcp.limblecmms.com/mcp",
        "--header",
        "Limble-Client-ID: YOUR_CLIENT_ID",
        "--header",
        "Limble-Client-Secret: YOUR_CLIENT_SECRET"
      ]
    }
  }
}

After saving, restart Claude Code.

Step 2: Verify the Connection

In your MCP client, try any of the following:

  • help() — overview and discovery

  • get_current_customer_info() — verifies authentication

  • get_tasks({"limit": 1}) — quick data fetch

  • list_mcp_tools({"format": "summary"}) — available tools

Troubleshooting

  • 403 (Unauthorized): Check your credentials or header format.

  • Endpoint unreachable: Verify the domain, path (/mcp).

  • Config syntax: Ensure JSON is valid (commas, quotes).

  • Client caching: Restart Cursor/Claude after changes.

Related Articles

Managing API Keys in Limble

Still don’t see what you’re looking for? Check out our YouTube channel for more tips and tricks! You can also reach out to us anytime at support@limblecmms.com.

Did this answer your question?