What are the requirements for Huly MCP?

Huly MCP requires the following environment variables: HULY_URL (required), HULY_EMAIL (optional), HULY_PASSWORD (optional), HULY_TOKEN (optional), HULY_WORKSPACE (required). You'll also need a compatible MCP client like Claude Desktop or Claude Code.

Is Huly MCP free to use?

Yes, Huly MCP is open source and free to use. You can find the source code on GitHub.

What MCP clients support Huly MCP?

Huly MCP works with any MCP-compatible client including Claude Desktop (Anthropic's official desktop app), Claude Code (CLI tool), Cursor, and other editors with MCP support.

How do I configure Huly MCP?

Configure Huly MCP by adding it to your MCP client's config file. The setup block at the top of this page generates a ready-to-paste config for Claude Code, Cursor, Codex, Windsurf, and Claude Desktop.

MCP server/other

Huly MCP Server

Q: What tools does Huly MCP provide?

list_projects: List all Huly projects.

Q: How do I install Huly MCP?

Install Huly MCP by running: npx -y @firfi/huly-mcp@latest

MCP server for Huly task tracker integration

★ 6 dearlordylord/huly-mcp ↗by dearlordylordupdated Apr 2, 2026

Add it to Claude Code

claude mcp add -e "HULY_URL=${HULY_URL}" -e "HULY_WORKSPACE=${HULY_WORKSPACE}" huly-mcp -- npx -y @firfi/huly-mcp@latest

Required:HULY_URLHULY_WORKSPACE+ 3 optional

Make your agent remember this setup

huly-mcp's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.

npx conare@latest

Free · one command · indexes the sessions already on disk. Set up in the browser instead →

What it does

Full integration with Huly task tracking platform
Supports multiple toolsets including issues, projects, and calendar
Flexible authentication via email/password or API token
Supports both stdio and HTTP transport modes
Configurable tool exposure via TOOLSETS environment variable

Tools 1

list_projectsList all Huly projects

Environment Variables

HULY_URLrequiredHuly instance URL

HULY_EMAILAccount email

HULY_PASSWORDAccount password

HULY_TOKENAPI token (alternative to email/password)

HULY_WORKSPACErequiredWorkspace identifier

Try it

→List all my active projects in Huly.

→Show me the list of projects available in my workspace.

→What projects are currently tracked in my Huly account?

Original README from dearlordylord/huly-mcp

@firfi/huly-mcp

MCP server for Huly integration.

Installation

The standard configuration works with most MCP clients:

{
  "mcpServers": {
    "huly": {
      "command": "npx",
      "args": ["-y", "@firfi/huly-mcp@latest"],
      "env": {
        "HULY_URL": "https://huly.app",
        "HULY_EMAIL": "[email protected]",
        "HULY_PASSWORD": "yourpassword",
        "HULY_WORKSPACE": "yourworkspace"
      }
    }
  }
}

<details> <summary>Claude Code</summary>

claude mcp add huly \
  -e HULY_URL=https://huly.app \
  -e [email protected] \
  -e HULY_PASSWORD=yourpassword \
  -e HULY_WORKSPACE=yourworkspace \
  -- npx -y @firfi/huly-mcp@latest

Or add to ~/.claude.json using the standard config above.

</details> <details> <summary>Claude Desktop</summary>

Add the standard config to your claude_desktop_config.json:

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

</details> <details> <summary>VS Code</summary>

Add to your user settings (.vscode/mcp.json) or use Command Palette → "MCP: Add Server":

{
  "servers": {
    "huly": {
      "command": "npx",
      "args": ["-y", "@firfi/huly-mcp@latest"],
      "env": {
        "HULY_URL": "https://huly.app",
        "HULY_EMAIL": "[email protected]",
        "HULY_PASSWORD": "yourpassword",
        "HULY_WORKSPACE": "yourworkspace"
      }
    }
  }
}

</details> <details> <summary>Cursor</summary>

Add the standard config to ~/.cursor/mcp.json, or via Settings → Tools & Integrations → New MCP Server.

</details> <details> <summary>Windsurf</summary>

Add the standard config to your Windsurf MCP configuration file.

</details>

Updating

The @latest tag in the install command always fetches the newest version. Most MCP clients cache the installed package, so you need to force a re-fetch:

Client	How to update
Claude Code	`claude mcp remove huly` then re-add with the install command above
Claude Desktop	Restart the app (it runs `npx` on startup)
VS Code / Cursor	Restart the MCP server from the command palette or reload the window
npx (manual)	`npx -y @firfi/huly-mcp@latest` — the `-y` flag skips the cache when `@latest` resolves to a new version

HTTP Transport

By default, the server uses stdio transport. For HTTP transport (Streamable HTTP):

HULY_URL=https://huly.app \
[email protected] \
HULY_PASSWORD=yourpassword \
HULY_WORKSPACE=yourworkspace \
MCP_TRANSPORT=http \
npx -y @firfi/huly-mcp@latest

Server listens on http://127.0.0.1:3000/mcp by default.

Configure with MCP_HTTP_PORT and MCP_HTTP_HOST:

MCP_TRANSPORT=http MCP_HTTP_PORT=8080 MCP_HTTP_HOST=0.0.0.0 npx -y @firfi/huly-mcp@latest

Environment Variables

Variable	Required	Description
`HULY_URL`	Yes	Huly instance URL
`HULY_EMAIL`	Auth*	Account email
`HULY_PASSWORD`	Auth*	Account password
`HULY_TOKEN`	Auth*	API token (alternative to email/password)
`HULY_WORKSPACE`	Yes	Workspace identifier
`HULY_CONNECTION_TIMEOUT`	No	Connection timeout in ms (default: 30000)
`MCP_TRANSPORT`	No	Transport type: `stdio` (default) or `http`
`MCP_HTTP_PORT`	No	HTTP server port (default: 3000)
`MCP_HTTP_HOST`	No	HTTP server host (default: 127.0.0.1)
`TOOLSETS`	No	Comma-separated tool categories to expose. If unset, all tools are exposed. Example: `issues,projects,search`

*Auth: Provide either HULY_EMAIL + HULY_PASSWORD or HULY_TOKEN.

Available Tools

TOOLSETS categories: projects, issues, comments, milestones, documents, storage, attachments, contacts, channels, calendar, time tracking, search, activity, notifications, workspace, cards, labels, tag-categories, test-management

Projects

Tool	Description
`list_projects`	List all Huly

Frequently Asked Questions

What are the key features of Huly MCP?

Full integration with Huly task tracking platform. Supports multiple toolsets including issues, projects, and calendar. Flexible authentication via email/password or API token. Supports both stdio and HTTP transport modes. Configurable tool exposure via TOOLSETS environment variable.

What can I use Huly MCP for?

Querying project status directly from the AI chat interface. Automating task management workflows within Huly. Integrating Huly project data into AI-assisted development sessions.

How do I install Huly MCP?

Install Huly MCP by running: npx -y @firfi/huly-mcp@latest

What MCP clients work with Huly MCP?

Huly MCP works with any MCP-compatible client including Claude Desktop, Claude Code, Cursor, and other editors with MCP support.

Conare · memory for coding agents

Turn this server into reusable context

Keep Huly MCP docs, env vars, and workflow notes in Conare so your agent carries them across sessions.

Set up free$npx conare@latest

Add it to Claude Code

Make your agent remember this setup

What it does

Tools 1

Environment Variables

Try it

@firfi/huly-mcp

Installation

Updating

HTTP Transport

Environment Variables

Available Tools

Projects

Frequently Asked Questions

Turn this server into reusable context

Related MCP Servers