huly-mcp-sdk

The most complete MCP server for Huly — the open-source project management platform.

Connects Claude Desktop (and any MCP-compatible client) directly to your Huly workspace. Manage projects, issues, milestones, components, documents, labels, and more — all via natural language.

---

Tools (36 total)

Category	Tool	Description
Projects	list_projects	List all projects in the workspace
	get_project	Get project details + available statuses
	create_project	Create a new tracker project with a unique identifier
Issues	list_issues	List issues with optional status / priority filters
	get_issue	Get full details of an issue (e.g. PROJ-42)
	create_issue	Create a new issue
	update_issue	Update title, status, priority, assignee, due date, component, milestone
	delete_issue	Permanently delete an issue by identifier
Comments	add_comment	Add a comment to an issue
	list_comments	List all comments on an issue (includes IDs for delete_comment)
	delete_comment	Delete a specific comment by ID
Time Tracking	log_time	Log hours spent on an issue
Labels	list_labels	List all labels with color + usage count
	create_label	Create a new label with an optional hex color
	add_label	Add a label to an issue (auto-creates if it doesn't exist)
	remove_label	Remove a label from an issue
Relations	add_relation	Mark two issues as related (bidirectional)
	add_blocked_by	Mark an issue as blocked by another issue
	set_parent	Set or clear the parent epic of an issue
Members	list_members	List workspace members
Milestones	list_milestones	List milestones for a project
	create_milestone	Create a milestone with a target date and status
Components	list_components	List components (sub-areas) in a project
	create_component	Create a new component with optional lead
Documents	list_teamspaces	List document teamspaces
	create_teamspace	Create a new teamspace (top-level document folder)
	list_documents	List documents in a teamspace
	delete_document	Permanently delete a document by ID
	get_document	Get document metadata + content
	create_document	Create a new document in a teamspace
	update_document	Write Markdown content to a document — Mermaid diagrams render natively
	link_document	Link a document to an issue — appears in the Relations panel
Search	search_issues	Full-text search across all issues

---

Requirements

• Node.js >= 20
• A Huly account — huly.app (cloud) or self-hosted

---

Quick Start

npx huly-mcp-sdk setup

This runs the interactive setup wizard — sends a one-time code to your email (works for Google/GitHub SSO accounts too) and writes your .env file automatically.

Your workspace slug is the part of your Huly URL after the domain: huly.app/myteam → slug is myteam.

---

Compatible Clients

The same MCP server works across all major AI coding tools. Pick your client.

Auth note: All config examples below use HULY_TOKEN. If you have issues with token expiry, use email + password instead — just replace the env block with:

"HULY_EMAIL": "your@email.com",
"HULY_PASSWORD": "yourpassword",
"HULY_WORKSPACE": "your-workspace-slug"

See Manual Auth for details on both options.

---

Claude Desktop

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "huly": {
      "command": "npx",
      "args": ["huly-mcp-sdk"],
      "env": {
        "HULY_TOKEN": "your-token",
        "HU

... [View full README on GitHub](https://github.com/varaprasadreddy9676/huly-mcp#readme)