Huly

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
HULY_EMAIL=your-email@example.com
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": "your-email@example.com",
        "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": "your-email@example.com",
        "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.