Huly MCP Server

Model Context Protocol server for connecting to Huly project management platform.

Features

Issue Management

• list_issues - List project issues
• get_issue - Get issue details
• create_issue - Create new issue
• update_issue - Update issue
• delete_issue - Delete issue
• set_assignee - Set assignee
• set_milestone - Set milestone

Project Management

• list_projects - List all projects
• get_project - Get project details

Milestone Management

• list_milestones - List project milestones
• get_milestone - Get milestone details
• create_milestone - Create new milestone
• delete_milestone - Delete milestone

Contact Management

• list_persons - List all contacts
• get_person - Get contact details

Label Management

• add_label - Add label to issue
• remove_label - Remove label from issue
• list_labels - List all available labels
• create_label - Create new label
• delete_label - Delete label

Relations

• add_relation - Add issue relation
• add_blocked_by - Add dependency
• set_parent - Set parent issue (subtask)

Metadata Queries

• list_task_types - List task types
• list_statuses - List all statuses

Configuration

Getting Credentials

1. Workspace: Workspace identifier (e.g. my-company from https://huly.app/my-company)
2. Email/Password: Your Huly account credentials

Environment Variables

# Required
HULY_WORKSPACE=your-workspace-identifier
HULY_EMAIL=your-email@example.com
HULY_PASSWORD=your-password

# Optional (default: https://huly.app)
HULY_URL=https://huly.app

CC-Switch

In CC-Switch, click the "MCP" button in the top-right corner:

1. Click "Add Server"
2. Configure:
   • Name: huly
   • Transport: stdio
   • Command: bunx
   • Args: ["@armoe/huly-mcp-server@latest"]
   • Environment:

     HULY_WORKSPACE=your-workspace
     HULY_EMAIL=your-email@example.com
     HULY_PASSWORD=your-password
     

3. Enable the server to sync to applications

Cherry Studio

In Cherry Studio settings, add a new MCP server:

{
  "name": "huly",
  "command": "bunx",
  "args": ["@armoe/huly-mcp-server@latest"],
  "env": {
    "HULY_WORKSPACE": "your-workspace",
    "HULY_EMAIL": "your-email@example.com",
    "HULY_PASSWORD": "your-password"
  }
}

Claude Desktop

Add to ~/.claude/claude_desktop_config.json:

{
  "mcpServers": {
    "huly": {
      "command": "bunx",
      "args": ["@armoe/huly-mcp-server@latest"],
      "env": {
        "HULY_WORKSPACE": "your-workspace",
        "HULY_EMAIL": "your-email@example.com",
        "HULY_PASSWORD": "your-password"
      }
    }
  }
}

Claude Code

Add to .claude/mcp.json:

{
  "mcpServers": {
    "huly": {
      "command": "bunx",
      "args": ["@armoe/huly-mcp-server@latest"],
      "env": {
        "HULY_WORKSPACE": "your-workspace",
        "HULY_EMAIL": "your-email@example.com",
        "HULY_PASSWORD": "your-password"
      }
    }
  }
}

Cursor

Add to VSCode settings (settings.json):

{
  "mcpServers": {
    "huly": {
      "command": "bunx",
      "args": ["@armoe/huly-mcp-server@latest"],
      "env": {
        "HULY_WORKSPACE": "your-workspace",
        "HULY_EMAIL": "your-email@example.com",
        "HULY_PASSWORD": "your-password"
      }
    }
  }
}

Cline (VSCode Extension)

Add to VSCode settings:

{
  "cline.mcpServers": {
    "huly": {
      "command": "bunx",
      "args": ["@armoe/huly-mcp-server@latest"],
      "env": {
        "HULY_WORKSPACE": "your-workspace",
        "HULY_EMAIL": "your-email@example.com",
        "HULY_PASSWORD": "your-password"
      }
    }
  }
}

Installation

Prerequisites

• Bun >= 1.3.0

From npm (Recommended)

bunx @armoe/huly-mcp-server@latest

From Source

git clone https://github.com/armoe/huly-mcp-server.git
cd huly-mcp-server
bun install

Usage

Standalone

# Set environment variables
export HULY_WORKSPACE=your-workspace
export HULY_EMAIL=your-email@example.com
export HULY_PASSWORD=your-password

# Run server
bun run src/index.ts

Development Mode

bun run dev

Development

# Type check
bun run typecheck

# Lint
bun run lint

# Auto-fix formatting
bun run lint:fix

# Format
bun run format

Project Structure

huly-mcp-server/
├── src/
│   ├── client.ts          # Huly API client
│   ├── config.ts          # Configuration loading
│   ├── index.ts           # Server entry
│   ├── tools/             # MCP tools implementation
│   │   ├── issue.ts       # Issue related tools
│   │   ├── label.ts       # Label related tools
│   │   ├── labelExtended.ts # Extended label and relation tools
│   │   ├── milestone.ts   # Milestone related tools
│   │   ├── person.ts      # Contact related tools
│   │   └── project.ts     # Project related tools
│   └── utils/             # Utility functions
│       └── converters.ts  # Type conversion functions
├── .mcp.json.example      # MCP configuration template
└── package.json

License

GPL-3.0-only

Related Links

• Model Context Protocol
• Huly Platform