huly-mcp-selfhost
Huly for AI agents. An MCP server for Huly — self-hosted or Huly Cloud — that lets Claude and other agents work in your workspaces: issues, epics, milestones, documents, chat, inbox, planner, test management and more. 227 tools, built for agent workflows and to spend as few tokens as possible.
Highlights
- Everything in Huly: tracker, documents, chat, inbox, activity, planner, calendar, GitHub PRs, contacts, drive, cards, templates, test management, recruiting, CRM, HR and more — plus read access to any Huly class.
- Made for agents: one-call overviews (
my_day, standup, project_report, get_issue_context), start_work → finish_work, plans → epics with sub-issues, specs and meeting notes → issues, claims for parallel agents, and huly-mcp watch to hand issues to Claude from Huly.
- Few tokens: tools come in toolsets (default ≈11k tokens, everything ≈24k), optionally loaded on demand; pin a workspace for −10 %; compact outputs; wrong parameters are rejected with the valid list instead of silently ignored.
- Safe by default: every change names its workspace, risky tools ask first, writes can be limited to projects, optional audit log — and
undo_changes reverses your last changes.
- Small and quick to install: one self-contained package of ~4 MB (900 kB download) — no 180 dependencies to fetch on the first
npx.
- No telemetry. The server talks to your Huly server and nothing else: no analytics, no usage tracking, nothing to opt out of. (The only other request, the npm version check, runs when you call
check_setup.)
- Claude Code plugin:
/huly:setup asks once per repo how Huly is used there and writes the rules; skill, hooks and /huly:* commands. Guides and a setup prompt for every other MCP client too.
- Self-hosted first: document and description content, file uploads and internal URLs work on
huly-selfhost; one account, all its workspaces.
Tokens, measured
What the model reads — measured on a real self-hosted project (≈60 issues):
| Characters | ≈ Tokens |
|---|
| Tool list, default toolsets (99 tools, each callable directly) | 38,991 | 11.1k |
| Tool list, pinned workspace | 35,299 | 10.1k |
| Open issues of a project (one call, ≈30 issues) | 2,768 | 0.8k |
| One issue with description | 318 | 0.1k |
| Project report (done, in progress, blocked, milestones, PRs, time) | ~2,700 | 0.8k |
| My day (calendar, to-dos, my issues, PRs, inbox) | ~1,200 | 0.3k |
Lists default to open items, empty fields are left out, and one call answers what would otherwise take four or five. Per call and question: costs.md.
Compared with another popular Huly MCP server
Same self-hosted Huly, same questions, the best parameters on both sides, measured 2026-11-11. For the other server only the text content is counted, not the duplicate JSON copy it also returns. Where we return more (components), it is because we include each component's description and code paths.
| Question | huly-mcp-selfhost | Other server | Ratio |
|---|
| Open issues of a project | 2,768 (1 call) | 11,601 (3 calls) | 4.2× less |
| Issues in progress | 211 (1 call) | 790 (1 call) | 3.7× less |
| One issue | 318 (1 call) | 585 (1 call) | 1.8× less |
| Everything about an issue (fields, sub-issues, comments, relations) | 1,246 (1 call) | 3,585 (4 calls) | 2.9× less |
| Search | 406 (1 call) | 1,405 (1 call) | 3.5× less |
| Projects | 550 (1 call) | 1,041 (1 call) | 1.9× less |
| Milestones | 208 (1 call) | 503 (1 call) | 2.4× less |
| Components | 1,302 (1 call) | 692 (1 call) | 2.0× more |
| Documents of a teamspace | 106 (1 call) | 305 (1 call) | 2.9× less |
| Tool definitions (49 tools with the same name) | 16,579 | 216,890 | 13.1× less |
Quick start
You need a Huly account — Huly Cloud or self-hosted — and, except for the Claude Desktop extension, Node.js 20+.
Claude Code — install the plugin, then fill in its settings when asked:
/plugin marketplace add JoKeks2023/huly-mcp
/plugin install huly@huly-mcp
Then run /huly:setup in a repository. Details: Claude Code plugin.
Claude Desktop — download huly-mcp-selfhost.mcpb, double-click it and enter your Huly login. Nothing else to install.
Cursor, VS Code, Windsurf, Zed, … (or Claude Desktop by hand) — add the server to your client's MCP config:
{
"mcpServers": {
"huly": {
"command": "npx",
"args": ["-y", "huly-mcp-selfhost"],
"env": {
"HULY_EMAIL": "[email protected]",
"HULY_PASSWORD": "your-password"
}
}
}
}
- Self-hosted Huly: add
"HULY_ACCOUNTS_URL": "https://huly.example.com/_accounts" and "HULY_FRONT_URL": "https://huly.example.com".
- Google/GitHub login (no password): run
npx huly-mcp-selfhost setup and use HULY_TOKEN instead — see Authentication.
- One workspace? Add
"HULY_WORKSPACE": "<slug>" — fewer tokens.
Config file locations and examples for each client: Compatible clients.
여기까지가 README 앞부분입니다. 나머지는 원문에서 읽을 수 있습니다. README 전문 보기 ↗
