Skip to content
MCP server

Huly MCP

Full-surface Huly workspace access for coding agents, from issues to recruiting

Runs locallyStatus and history
Install
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-mcp

Add 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.Required
  • HULY_URLReachable self-hosted or replacement hosted Huly API URLRequired
  • HULY_EMAILYour Huly account emailRequired
  • HULY_PASSWORDYour Huly account passwordRequired
  • HULY_WORKSPACEHuly workspace identifierRequired
  • HULY_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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity