Huly MCP
Full-surface Huly workspace access for coding agents, from issues to recruiting
- Pricing
- Open source
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 0.56.0
- Listing updated
- 3 days ago
About Huly MCP
Huly MCP is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.
Huly MCP is a TypeScript server that turns a Huly workspace into tools an agent can plan, inspect, update and verify work with. The surface is wide: projects, issues, comments, milestones, documents, contacts, calendar, time tracking, boards, cards, leads, recruiting, mail, processes, test management and administration areas, among others.
Setup is a Node.js 22.19 or later runtime and an npx command. You supply the URL of a Huly instance, the workspace, and either an API token or an email and password. The README advises a managed, workspace-bound token on a dedicated integration account, since tokens inherit that account's rights. If the Node version is too old, the server starts a diagnostic-only surface and reports the problem through a startup diagnostic tool.
The same maintainers publish a Huly CLI built from the same operation registry for shell scripting. Platform Collective and TraceX forks should work too, with fork support called unofficial.
Install
Run in a terminal
claude mcp add huly-mcp --env MCP_TRANSPORT='<MCP_TRANSPORT>' --env HULY_URL='<HULY_URL>' --env HULY_EMAIL='<HULY_EMAIL>' --env HULY_PASSWORD='<HULY_PASSWORD>' --env HULY_WORKSPACE='<HULY_WORKSPACE>' -- npx -y @firfi/huly-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"huly-mcp": {
"command": "npx",
"args": [
"-y",
"@firfi/huly-mcp"
],
"env": {
"MCP_TRANSPORT": "<MCP_TRANSPORT>",
"HULY_URL": "<HULY_URL>",
"HULY_EMAIL": "<HULY_EMAIL>",
"HULY_PASSWORD": "<HULY_PASSWORD>",
"HULY_WORKSPACE": "<HULY_WORKSPACE>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"huly-mcp": {
"command": "npx",
"args": [
"-y",
"@firfi/huly-mcp"
],
"env": {
"MCP_TRANSPORT": "<MCP_TRANSPORT>",
"HULY_URL": "<HULY_URL>",
"HULY_EMAIL": "<HULY_EMAIL>",
"HULY_PASSWORD": "<HULY_PASSWORD>",
"HULY_WORKSPACE": "<HULY_WORKSPACE>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"huly-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@firfi/huly-mcp"
],
"env": {
"MCP_TRANSPORT": "<MCP_TRANSPORT>",
"HULY_URL": "<HULY_URL>",
"HULY_EMAIL": "<HULY_EMAIL>",
"HULY_PASSWORD": "<HULY_PASSWORD>",
"HULY_WORKSPACE": "<HULY_WORKSPACE>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"huly-mcp": {
"command": "npx",
"args": [
"-y",
"@firfi/huly-mcp"
],
"env": {
"MCP_TRANSPORT": "<MCP_TRANSPORT>",
"HULY_URL": "<HULY_URL>",
"HULY_EMAIL": "<HULY_EMAIL>",
"HULY_PASSWORD": "<HULY_PASSWORD>",
"HULY_WORKSPACE": "<HULY_WORKSPACE>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"huly-mcp": {
"command": "npx",
"args": [
"-y",
"@firfi/huly-mcp"
],
"env": {
"MCP_TRANSPORT": "<MCP_TRANSPORT>",
"HULY_URL": "<HULY_URL>",
"HULY_EMAIL": "<HULY_EMAIL>",
"HULY_PASSWORD": "<HULY_PASSWORD>",
"HULY_WORKSPACE": "<HULY_WORKSPACE>"
}
}
}
}Configuration
MCP_TRANSPORTLocal MCP runtime: resident shares a backend across compatible clients; stdio uses a separate backend per client.RequiredHULY_URLReachable self-hosted or replacement hosted Huly API URLRequiredHULY_EMAILYour Huly account emailRequiredHULY_PASSWORDYour Huly account passwordRequiredHULY_WORKSPACEHuly workspace identifierRequiredHULY_CONNECTION_TIMEOUTConnection timeout in milliseconds. Omit to use the package default.HULY_TOOL_MODETool exposure mode: auto (default), native, or proxy. Auto keeps exact claude-code native and resolves Codex, Cursor, Windsurf, Copilot, opencode, Claude AI, and unknown clients to proxy mode.PROXY_OUTPUT_STRICTSet true to make active TOOLSETS / TOOLS a hard allow-list for proxy search, schema lookup, and invocation. Defaults to false.TOOLSETSComma-separated native Huly tool categories to expose, such as issues,projects,search. If unset with TOOLS, all native tools are exposed.TOOLSComma-separated exact native Huly tool names to expose in addition to selected TOOLSETS, such as list_documents,create_issue.
Tools this server provides (1)
Taken from the project documentation; the running server may differ.
- get_huly_startup_diagnostic
- Reports the detected Node.js executable and required version when the runtime is unsupported.
What it does
- Broad Huly coverage
- Projects, issues, documents, calendar, recruiting, support and more.
- Agent-friendly results
- Forgiving identifiers, rich output and typed errors.
- Token or password login
- Managed API token preferred, email and password as fallback.
- Tool exposure modes
- A HULY_TOOL_MODE setting controls which tools are shown.
- Startup diagnostic
- Reports an unsupported Node.js runtime instead of failing silently.
- CLI sibling
- A Huly CLI shares the same operation registry.
Good for
- Have an agent triage and update Huly issues
- Log time and comments from a coding session
- Read and edit Huly documents
- Track candidates through recruiting
- Script Huly changes in CI with the companion CLI
Pricing
Open source
MIT licensed; free to run
Prices change. Check huly-mcp.dearlordylord.com before you buy.
Huly MCP FAQ
What runtime does it need?
Node.js 22.19.0 or later in the environment where the client runs.
How does it authenticate?
With a Huly API token, or an email and password.
Does it work with Huly forks?
It should work with Platform Collective and TraceX; the README calls this unofficial.
What is the licence?
MIT, per the README badge.
Is Huly MCP free?
Yes. Huly MCP is open source, so you can use and self-host it for free.
How do I add Huly MCP to Claude Code?
Run this command in your terminal: claude mcp add huly-mcp --env MCP_TRANSPORT='<MCP_TRANSPORT>' --env HULY_URL='<HULY_URL>' --env HULY_EMAIL='<HULY_EMAIL>' --env HULY_PASSWORD='<HULY_PASSWORD>' --env HULY_WORKSPACE='<HULY_WORKSPACE>' -- npx -y @firfi/huly-mcp
What are the best alternatives to Huly MCP?
The closest alternatives to Huly MCP are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to Huly MCP

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity