Huly MCP logo

Huly MCP

Connects MCP clients to Huly for managing projects, issues, documents, members, labels, milestones, and more.

Install Huly MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "huly-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "huly-mcp-sdk"
      ],
      "env": {
        "HULY_TOKEN": "YOUR_VALUE_HERE",
        "HULY_WORKSPACE": "YOUR_VALUE_HERE",
        "HULY_EMAIL": "YOUR_VALUE_HERE",
        "HULY_PASSWORD": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y huly-mcp-sdk

Process exited before answering initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 1d ago.

Overview

The huly-mcp MCP server connects MCP-compatible clients to a Huly workspace through a standard stdio process. It exposes tools for projects, issues, comments, time tracking, labels, relations, members, milestones, components, documents, and issue search. Authentication uses a Huly token or email and password, together with a workspace slug. Reach for it when an agent needs to read or modify Huly project-management data from Claude, Cursor, Windsurf, or another MCP client.

Use cases

  • Create and update Huly issues from an AI coding client
  • Search issues and review their comments
  • Track milestones, components, labels, and issue relations
  • Create and update Markdown documents in teamspaces
  • Log time against Huly issues

Key features

  • Project and issue management
  • Comments, labels, relations, and time tracking
  • Milestone, component, and member access
  • Document and teamspace management
  • Full-text issue search
  • Standard stdio transport

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

8/8 checks healthy over the last 50d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 13d ago via OSV.dev · huly-mcp-sdk (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars5Stargazers on the source repository.
npm downloads157Package downloads in the last 30 days.
Last commit7mo agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.

How Huly MCP works

What huly-mcp MCP server does

The huly-mcp MCP server gives an AI client access to a Huly workspace through MCP tools. Huly can be hosted at huly.app or self-hosted, and the server uses the workspace slug from the Huly URL to select the target workspace.

Its 36 tools cover project and issue administration, collaboration, planning, documentation, and search. An agent can inspect or create projects, retrieve and modify issues, manage comments, record time, apply labels, define issue relationships, and list workspace members. It can also work with milestones and project components.

Document support includes teamspaces, document creation and retrieval, Markdown updates, deletion, and linking a document to an issue.

How it works

The huly-mcp MCP server runs over standard stdio transport. A compatible client starts the package with npx huly-mcp-sdk, then supplies authentication and workspace settings as environment variables. Requests from the client are exposed as named MCP tools rather than requiring the agent to interact with Huly’s interface directly.

Authentication can use HULY_TOKEN, or HULY_EMAIL and HULY_PASSWORD when token expiry is a problem. Google and GitHub SSO accounts are supported by the interactive setup flow, which sends a one-time code by email. The workspace is selected with HULY_WORKSPACE.

Setup and configuration

Node.js 20 or newer and a Huly account are required. The quickest setup path is:

Terminal
npx huly-mcp-sdk setup

The wizard writes an .env file after authentication. The workspace slug is the segment after the domain in a Huly URL; for example, huly.app/myteam gives the slug myteam.

For clients that do not use the package directly, clone the repository, install dependencies, and build it:

bash
git clone https://github.com/varaprasadreddy9676/huly-mcp.git
cd huly-mcp && npm install && npm run build

The compiled server can then be launched with Node and the absolute path to dist/index.js.

Tools and capabilities

The huly-mcp MCP server provides tools to:

  • List, inspect, and create projects.
  • List, search, create, update, and delete issues.
  • Add, list, and delete issue comments.
  • Log time and manage labels.
  • Add relations, blocked-by links, and parent relationships.
  • List members, milestones, and components; create milestones and components.
  • List teamspaces and documents, create or update documents, delete documents, and link documents to issues.

Issue updates can change fields such as status, priority, assignee, due date, component, and milestone. Issue listing supports status and priority filters, while search performs full-text matching across issues.

Limitations and notes

The server uses stdio rather than a hosted HTTP endpoint. Client configuration details vary by application, although the command, package argument, and environment-variable pattern remain the same for standard MCP clients.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Huly MCP

huly-mcp is an MCP server that connects AI clients to Huly workspaces. Its main tools manage projects, issues, comments, labels, milestones, components, documents, members, relations, and time entries, while also supporting full-text issue search. It runs over standard stdio and authenticates with a token or Huly email and password.

Install it by running `npx huly-mcp-sdk setup` with Node.js 20 or newer. The interactive wizard authenticates your Huly account and writes an `.env` file. You can also clone the repository, run `npm install`, and build the server for direct execution.

Yes, huly-mcp works with Cursor through its MCP configuration file. Add a server entry that runs `npx huly-mcp-sdk` and provides `HULY_TOKEN` plus `HULY_WORKSPACE`, then restart Cursor so the tools appear in its Agent panel.

It requires either a Huly token with a workspace slug or Huly email, password, and workspace slug. The setup wizard supports accounts using Google or GitHub SSO by sending a one-time code to the account email.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewHuly MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/huly-mcp?style=directory)](https://allmcps.com/mcp/huly-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/huly-mcp"><img src="https://allmcps.com/api/badge/huly-mcp?style=directory" alt="Huly MCP on AllMCPs" /></a>