bgx4k3p/huly-mcp-server
Universal MCP server for Huly project management — issue tracking, projects, milestones, labels, time tracking, and workspace management. Supports stdio (Claude Code) and Streamable HTTP transports. Self-hosted Huly SDK wrapper with multi-workspace support.
Platform-specific configuration:
{
"mcpServers": {
"huly-mcp-server": {
"command": "npx",
"args": [
"-y",
"huly-mcp-server"
]
}
}
}Add the config above to .claude/settings.json under the mcpServers key.
[](LICENSE) [](https://nodejs.org) [](https://modelcontextprotocol.io) [](https://huly.io) [](Dockerfile)
MCP server providing full coverage of the Huly SDK — issues, projects, workspaces, members, and account management. Two transports: stdio for local tools and Streamable HTTP for remote clients. Tested against self-hosted Huly. May also work with Huly Cloud (not yet tested).
Huly has no public API. The only programmatic access is through their JavaScript SDK, which connects via WebSocket. This server wraps that SDK and exposes MCP tools over both stdio and Streamable HTTP transports — compatible with Claude Code, VS Code, n8n, and any MCP client.
git clone https://github.com/bgx4k3p/huly-mcp-server.git
cd huly-mcp-server
npm install> Note: The Huly SDK publishes packages with pnpm workspace: > protocol in transitive dependencies, which prevents npx and > global npm installs from working. Clone from source is required.
---
You can authenticate with either email/password or a token.
export HULY_URL=https://your-huly-instance.com
export HULY_EMAIL=your@email.com
export HULY_PASSWORD=your-password
export HULY_WORKSPACE=your-workspaceGet a token from your Huly credentials — no env vars needed beforehand:
node src/index.mjs --get-token -e your@email.com -p your-password -u https://your-huly-instance.comThen use it:
export HULY_URL=https://your-hulLoading reviews...