Huly MCP Server

MCP (Model Context Protocol) server for Huly integration with Claude Code.

Installation

Install globally from npm:

npm install -g huly-mcp

Setup

Run the setup wizard to configure your credentials:

huly-mcp-setup

Enter the following when prompted:

Huly URL: http://139.185.54.63
Your Huly email: your-email
Your Huly password: your-password
Workspace name: sentiment-ai

That's it! The setup automatically configures ~/.claude.json for you.

Updating

To update to the latest version:

npm update -g huly-mcp

After updating, restart Claude Code for changes to take effect.

Usage

After setup:

1. Restart Claude Code
2. Run /mcp and enable the Huly server
3. Use the following tools:

Available Tools

Projects:

• mcp__huly__create_project - Create new projects with identifier, title, description, privacy settings
• mcp__huly__list_projects - List all projects
• mcp__huly__list_my_projects - List projects where you're a member
• mcp__huly__delete_project - Delete a project

Issues:

• mcp__huly__create_issue - Create issues with title, description (Markdown), priority (urgent/high/medium/low), project, assignee, and component
• mcp__huly__list_issues - List issues with human-readable status, optionally filter by project
• mcp__huly__update_issue - Update issue title, description, priority, status (Done/In Progress/Todo/Backlog/Canceled), assignee, and component
• mcp__huly__delete_issue - Delete an issue

Components:

• mcp__huly__create_component - Create project components (Frontend/Backend/Database etc) with descriptions
• mcp__huly__list_components - List all components in a project
• mcp__huly__update_component - Update component label and description
• mcp__huly__delete_component - Delete a component

Milestones:

• mcp__huly__create_milestone - Create milestones with label, target date, status, description
• mcp__huly__list_milestones - List all milestones in a project
• mcp__huly__update_milestone - Update milestone label, description, status, and target date
• mcp__huly__delete_milestone - Delete a milestone

Manual Configuration

If you prefer to manually edit ~/.claude.json:

{
  "mcpServers": {
    "huly": {
      "command": "huly-mcp",
      "env": {
        "HULY_URL": "http://your-huly-instance.com",
        "HULY_EMAIL": "[email protected]",
        "HULY_PASSWORD": "your-password",
        "HULY_WORKSPACE": "your-workspace"
      }
    }
  }
}

Development

git clone https://github.com/SentimentAILtd/huly-mcp.git
cd huly-mcp
npm install
npm run build

License

MIT