tooljet-mcp

tooljet-mcp

2

ToolJet MCP is a protocol integration that enables AI assistants to interact with the ToolJet platform for managing users, workspaces, and applications. It's designed to enhance functionality by allowing programmatic control through compatible AI tools.

ToolJet MCP

Empower your AI assistants with direct access to your ToolJet platform. This MCP (Model Context Protocol) integration enables AI tools like Claude, Cursor, and other MCP-compatible assistants to interact with your ToolJet instance.

What is ToolJet MCP?

ToolJet MCP is a bridge that connects AI assistants to your ToolJet platform through the Model Context Protocol. This allows AI tools to:

  • Manage users and workspaces
  • Access app information
  • Perform administrative tasks
  • Interact with your ToolJet instance programmatically

Getting Started

Requirements

  • Node.js (v14 or higher)
  • A ToolJet instance with admin access
  • An MCP-compatible AI assistant (Claude, Cursor, etc.)

Configuration

Step 1: Get an Access Token

Get an access token of your ToolJet instance that you've setup up in your environment variables. You'll need this token to authenticate the MCP server. Refer to the ToolJet API documentation for more details.

Step 2: Set Up Your AI Assistant

Configure your MCP client (such as Claude, Cursor, etc.) to use this server. Most MCP clients store the configuration as JSON in the following format:

{
  "mcpServers": {
    "tooljet": {
      "command": "npx",
      "args": [
        "-y",
        "@tooljet/mcp"
      ],
      "env": {
        "TOOLJET_ACCESS_TOKEN": "your-access-token",
        "TOOLJET_HOST": "https://your-tooljet-instance.com"
      }
    }
  }
}

Platform-Specific Setup

Windows Users

If you're using Windows, prefix the command with cmd /c:

{
  "mcpServers": {
    "tooljet": {
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "@tooljet/mcp"
      ],
      "env": {
        "TOOLJET_ACCESS_TOKEN": "your-access-token",
        "TOOLJET_HOST": "https://your-tooljet-instance.com"
      }
    }
  }
}

Available Tools

ToolJet MCP provides several tools that AI assistants can use to interact with your ToolJet instance:

User Management

ToolDescription
get-all-usersRetrieve a list of all users in your ToolJet instance
get-userGet detailed information about a specific user
create-userCreate a new user in a specified workspace
update-userUpdate a user's profile information
update-user-roleChange a user's role within a workspace

Workspace Management

ToolDescription
get-all-workspacesList all workspaces in your ToolJet instance

Application Management

ToolDescription
get-all-appsList all applications within a specific workspace

Example Usage

Once configured, your AI assistant can perform tasks like:

  • "Show me all users in my ToolJet instance"
  • "Create a new user named John Doe in the Marketing workspace"
  • "List all the apps in the Development workspace"
  • "Update the role of to Admin in the Sales workspace"

Development

Want to contribute to ToolJet MCP? Here's how to set up the development environment:

# Clone the repository
git clone https://github.com/ToolJet/tooljet-mcp

# Install dependencies
cd mcp
npm install

# Build the project
npm run build

Learn More