# Huly MCP

> Huly MCP is an open-source MCP server for productivity. Full-surface Huly workspace access for coding agents, from issues to recruiting. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://huly-mcp.dearlordylord.com
- **Repository:** https://github.com/dearlordylord/huly-mcp
- **MCP Registry name:** io.github.dearlordylord/huly-mcp
- **Categories:** productivity, developer tools
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## Tools

- `get_huly_startup_diagnostic`: Reports the detected Node.js executable and required version when the runtime is unsupported.

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/huly-mcp
