home / mcp / huly mcp server

Huly MCP Server

Provides a remote MCP server that connects to Huly, resolves project IDs, and creates issues with correct fields.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "hha-nguyen-huly-mcp-server": {
      "url": "http://your-server-ip:3000/mcp",
      "headers": {
        "HULY_URL": "https://workspace.teasersoftware.com",
        "HULY_EMAIL": "[email protected]",
        "HULY_PASSWORD": "your-password",
        "HULY_WORKSPACE": "Teaser Software"
      }
    }
  }
}

You can deploy this MCP server to connect your Huly workspace to the MCP ecosystem. It runs on your remote server, talks to the Huly WebSocket API, and helps Cursor or other MCP clients create and manage issues with correct fields and project scopes.

How to use

You will run the MCP server on a remote machine or start it locally for development, then connect your MCP client (such as Cursor) to it. The server authenticates with your Huly workspace and automatically resolves project identifiers and task kinds so you can create and list issues with accurate metadata.

How to install

Prerequisites: you need Node.js and npm installed on your machine. You will also configure access to your Huly workspace using your credentials.

Configuration and running on a remote server

1) Copy the MCP server to your remote host and install dependencies.

cd /path/to/huly-mcp-server
npm install
npm run build

Environment configuration

Create a local environment file or export the following variables to enable the MCP server to connect to Huly and listen on the desired port.

Environment example

HULY_URL=https://workspace.teasersoftware.com
[email protected]
HULY_PASSWORD=your-password
HULY_WORKSPACE=Teaser Software
PORT=3000

Running on the remote server

Start the server on the remote machine to listen for MCP connections.

npm start
# or for development
npm run dev

Connecting from Cursor

You can connect either via an HTTP server on the remote host or via a local stdio server. Use the appropriate MCP server configuration in Cursor.

HTTP server configuration (remote)

{
  "mcpServers": {
    "huly_remote": {
      "url": "http://your-server-ip:3000/mcp",
      "env": {
        "HULY_URL": "https://workspace.teasersoftware.com",
        "HULY_EMAIL": "[email protected]",
        "HULY_PASSWORD": "your-password"
      }
    }
  }
}

Stdio server configuration (local)

{
  "mcpServers": {
    "huly_local": {
      "command": "node",
      "args": ["/absolute/path/to/huly-mcp-server/dist/index.js"],
      "env": {
        "HULY_URL": "https://workspace.teasersoftware.com",
        "HULY_EMAIL": "[email protected]",
        "HULY_PASSWORD": "your-password"
      }
    }
  }
}

Available tools

create_issue

Create issues with correct fields, including attachedToClass, collection, and kind.

list_issues

List issues from projects.

list_projects

List all projects.