huly-mcp — Claude Code MCP server: what it does, how to install
Links Huly workspace to your AI assistant with 36 tools for tasks, projects, time logs, and documentation.
no license ★ 5 updated 2026-03-18
claude mcp add --env HULY_TOKEN=<HULY_TOKEN> --env HULY_WORKSPACE=<HULY_WORKSPACE> --env HULY_FRONT_URL=<HULY_FRONT_URL> --transport stdio varaprasadreddy9676-huly-mcp -- npx -y huly-mcp-sdkWhat huly-mcp does
This server hooks your coding agent directly to a Huly workspace, whether hosted in the cloud at huly.app or self-hosted. It exposes 36 distinct tools. They cover project lists, issue updates, team member assignments, and full-text searches across all workspace tickets.
Beyond task tracking, the integration handles documents inside project teamspaces. The model can draft Markdown pages with native Mermaid diagrams and link those records directly to issues. Authentication relies on your workspace slug alongside HULY_TOKEN, or standard account credentials if token expiration causes trouble.
Running huly-mcp-sdk requires Node.js 20 or newer. You can configure credentials by running npx huly-mcp-sdk setup, which delivers a single-use verification code to your inbox and writes the .env parameters automatically.
What it helps with
- create and update tickets without leaving the terminal
- log work hours against specific issue IDs
- search issues across the entire workspace using plain queries
- write Markdown documentation with embedded Mermaid graphs
- assign labels, blockers, and parent epics to items
Example prompts for the agent
- File a new high-priority issue under the API project and assign it to the next milestone
- Log 3 hours on PROJ-15 with a note about the database schema migration
- Search for open bug reports mentioning authentication failures
How to install huly-mcp
Platform CLI
claude mcp add --env HULY_TOKEN=<HULY_TOKEN> --env HULY_WORKSPACE=<HULY_WORKSPACE> --env HULY_FRONT_URL=<HULY_FRONT_URL> --transport stdio varaprasadreddy9676-huly-mcp -- npx -y huly-mcp-sdkReplace <…> with your own values
Platform CLI
codex mcp add varaprasadreddy9676-huly-mcp --env HULY_TOKEN=<HULY_TOKEN> --env HULY_WORKSPACE=<HULY_WORKSPACE> --env HULY_FRONT_URL=<HULY_FRONT_URL> -- npx -y huly-mcp-sdkReplace <…> with your own values
Config file
{
"mcpServers": {
"varaprasadreddy9676-huly-mcp": {
"command": "npx",
"args": [
"-y",
"huly-mcp-sdk"
],
"env": {
"HULY_TOKEN": "<HULY_TOKEN>",
"HULY_WORKSPACE": "<HULY_WORKSPACE>",
"HULY_FRONT_URL": "<HULY_FRONT_URL>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"varaprasadreddy9676-huly-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"huly-mcp-sdk"
],
"env": {
"HULY_TOKEN": "<HULY_TOKEN>",
"HULY_WORKSPACE": "<HULY_WORKSPACE>",
"HULY_FRONT_URL": "<HULY_FRONT_URL>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e HULY_TOKEN=<HULY_TOKEN> -e HULY_WORKSPACE=<HULY_WORKSPACE> -e HULY_FRONT_URL=<HULY_FRONT_URL> varaprasadreddy9676-huly-mcp npx -y huly-mcp-sdkReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about huly-mcp
How to install huly-mcp in Claude Code?
Run claude mcp add huly-mcp -e HULY_TOKEN=<HULY_TOKEN> -e HULY_WORKSPACE=<HULY_WORKSPACE> -- npx -y huly-mcp-sdk. Make sure to insert your real workspace slug and access token into the placeholders.
What does huly-mcp do?
It connects MCP-enabled assistants to the Huly management platform through 36 purpose-built tools. It allows managing issues, milestones, comments, work time, and collaborative documents via chat.
What are the system requirements for huly-mcp?
You need Node.js version 20 or higher and an active Huly account, either cloud-based or self-hosted. Credentials can be retrieved through the interactive npx huly-mcp-sdk setup script.