# huly-mcp

Links Huly workspace to your AI assistant with 36 tools for tasks, projects, time logs, and documentation.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5 repo stars
- Author: varaprasadreddy9676
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/varaprasadreddy9676/huly-mcp
- Updated: 2026-03-18
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/varaprasadreddy9676-huly-mcp

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `HULY_TOKEN`, `HULY_WORKSPACE`, `HULY_FRONT_URL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
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-sdk
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
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-sdk
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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

### Gemini CLI

**Platform CLI**
```bash
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-sdk
```
Replace <…> with your own values

## When to use it
- 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
- 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

## Similar
- [Huly MCP](https://affpapa.org/en/nevibecode/mcp/huly-mcp.md) — MCP server · ★ 64 repo stars
- [Astravue MCP](https://affpapa.org/en/nevibecode/mcp/astravue-mcp.md) — MCP server · ★ 12 repo stars
- [Linear](https://affpapa.org/en/nevibecode/mcp/docker-linear.md) — MCP server
- [clickup](https://affpapa.org/en/nevibecode/skills/willmarple-clickup.md) — skill · 1 install
- [astravue](https://affpapa.org/en/nevibecode/plugins/astravue.md) — plugin · ★ 12 repo stars
- [01-ticket-info](https://affpapa.org/en/nevibecode/skills/01-ticket-info.md) — skill · ★ 571 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
