Huly
About
MCP server for Huly project management system Browse Huly MCP Server for Claude, Cursor, VS Code, and other AI agents.
Details
- Transport
- SSE
Explore
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
HulyCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
get_version
Returns the current version of this Huly MCP server and the latest version available on npm.
list_projects
List all Huly projects. Returns projects sorted by name. Supports filtering by archived status.
get_project
Get full details of a Huly project including its statuses. Returns project name, description, archived flag, default status, and all available statuses.
list_statuses
List all issue statuses for a Huly project with category info. Returns status name, isDone, isCanceled, and isDefault flags. Use this to discover valid statuses before creating or updating issues.
create_project
Create a new Huly tracker project. Idempotent: returns existing project if one with the same identifier already exists (created=false). Identifier must be 1-5 uppercase alphanumeric chars starting with a letter.
update_project
Update a Huly project. Only provided fields are modified. Set description to null to clear it.
delete_project
Permanently delete a Huly project. All issues, milestones, and components in this project will be orphaned. This action cannot be undone.
list_issues
Query Huly issues with optional filters. Returns issues sorted by modification date (newest first). Supports filtering by project, status, assignee, component, and parentIssue (to list children of a specific issue). Supports searching by title substring (titleSearch) and description content (descriptionSearch).
get_issue
Retrieve full details for a Huly issue including markdown description. Use this to view issue content, comments, or full metadata.
create_issue
Create a new issue in a Huly project. Optionally set taskType by ID or display name; it is resolved within the target project's project type, and status is validated against that task type's workflow. Use list_task_types or get_project_type to discover valid task types and statuses. Optionally create as a sub-issue by specifying parentIssue. Description supports markdown formatting. Returns the created issue identifier.
update_issue
Update fields on an existing Huly issue. Optionally set taskType by ID or display name; it is resolved within the target project's project type, and the status is preserved only when valid for the new task type. Use list_task_types or get_project_type to discover valid task types and statuses. Only provided fields are modified. Description updates support markdown.
add_issue_label
Add a tag/label to a Huly issue. Creates the tag if it doesn't exist in the project.
remove_issue_label
Remove a tag/label from a Huly issue. Detaches the label reference; does not delete the label definition.
delete_issue
Permanently delete a Huly issue. This action cannot be undone.
move_issue
Move an issue to a new parent (making it a sub-issue) or to top-level (null). Updates parent/child relationships and sub-issue counts.
list_components
List components in a Huly project. Components organize issues by area/feature. Returns components sorted by modification date (newest first).
get_component
Retrieve full details for a Huly component. Use this to view component content and metadata.
create_component
Create a new component in a Huly project. Components help organize issues by area/feature. Returns the created component ID and label.
update_component
Update fields on an existing Huly component. Only provided fields are modified.
set_issue_component
Set or clear the component on a Huly issue. Pass null for component to clear it.
delete_component
Permanently delete a Huly component. This action cannot be undone.
list_issue_templates
List issue templates in a Huly project. Templates define reusable issue configurations. Returns templates sorted by modification date (newest first).
get_issue_template
Retrieve full details for a Huly issue template including children (sub-task templates). Use this to view template content, default values, and child template IDs.
create_issue_template
Create a new issue template in a Huly project. Templates define default values for new issues. Optionally include children (sub-task templates) that will become sub-issues when creating issues from this template. Returns the created template ID and title.
create_issue_from_template
Create a new issue from a template. Applies template defaults, allowing overrides for specific fields. If the template has children (sub-task templates), sub-issues are created automatically unless includeChildren is set to false. Returns the created issue identifier and count of children created.
update_issue_template
Update fields on an existing Huly issue template. Only provided fields are modified.
delete_issue_template
Permanently delete a Huly issue template. This action cannot be undone.
add_template_child
Add a child (sub-task) template to an issue template. The child defines default values for sub-issues created when using create_issue_from_template. Returns the child template ID.
remove_template_child
Remove a child (sub-task) template from an issue template by its child ID. Get child IDs from get_issue_template response.
add_issue_relation
Add a relation between two issues. Relation types: 'blocks' (source blocks target — pushes into target's blockedBy), 'is-blocked-by' (source is blocked by target — pushes into source's blockedBy), 'relates-to' (bidirectional link — updates both sides). targetIssue accepts cross-project identifiers like 'OTHER-42'. No-op if the relation already exists.
remove_issue_relation
Remove a relation between two issues. Mirrors add_issue_relation: 'blocks' pulls from target's blockedBy, 'is-blocked-by' pulls from source's blockedBy, 'relates-to' pulls from both sides. No-op if the relation doesn't exist.
list_issue_relations
List all relations of an issue. Returns blockedBy (issues blocking this one), blocks (issues this one blocks), relations (bidirectional issue links), and documents (linked documents with title/teamspace).
link_document_to_issue
Link a Huly document to an issue. The link appears in the issue's Relations panel in the UI. Idempotent: no-op if the document is already linked. Use list_issue_relations to see linked documents.
unlink_document_from_issue
Remove a document link from an issue. Idempotent: no-op if the document is not linked.
list_labels
List label/tag definitions in the workspace. Labels are global (not project-scoped). Returns labels for tracker issues sorted by modification date (newest first).
create_label
Create a new label/tag definition in the workspace. Labels are global and can be attached to any issue. Returns existing label if one with the same title already exists (created=false). Use add_issue_label to attach a label to a specific issue.
update_label
Update a label/tag definition. Accepts label ID or title. Only provided fields are modified.
delete_label
Permanently delete a label/tag definition. Accepts label ID or title. This action cannot be undone.
list_tag_categories
List tag/label categories in the workspace. Categories group labels (e.g., 'Priority Labels', 'Type Labels'). Optional targetClass filter (defaults to all).
create_tag_category
Create a new tag/label category. Idempotent: returns existing category if one with the same label and targetClass already exists (created=false). Defaults targetClass to tracker issues.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"huly": {
"server": {
"command": "npx",
"args": [
"-y",
"@firfi/huly-mcp"
],
"env": {
"HULY_URL": "",
"HULY_EMAIL": "",
"HULY_PASSWORD": "",
"HULY_WORKSPACE": "",
"HULY_CONNECTION_TIMEOUT": "",
"HULY_TOOL_MODE": "",
"PROXY_OUTPUT_STRICT": "",
"TOOLSETS": "",
"TOOLS": ""
}
}
}
}
}McpServers
{
"server": {
"command": "npx",
"args": [
"-y",
"@firfi/huly-mcp"
],
"env": {
"HULY_URL": "",
"HULY_EMAIL": "",
"HULY_PASSWORD": "",
"HULY_WORKSPACE": "",
"HULY_CONNECTION_TIMEOUT": "",
"HULY_TOOL_MODE": "",
"PROXY_OUTPUT_STRICT": "",
"TOOLSETS": "",
"TOOLS": ""
}
}
}Transport
"stdio"Package
"@firfi/huly-mcp"Registry
"npm"Self-hosted Huly: account locked after failed login attempts
Huly locks password login after 5 failed API authentication attempts. This commonly happens during initial setup when the password is misconfigured. The lock persists in the database across service restarts.
Symptoms:PasswordLoginLockederror from the MCP server, and the Huly web UI shows "Password login is locked due to too many failed attempts. Please use an OTP login method to unlock your account." (OTP won't work without SMTP configured.)
Fix— reset the lock counter in CockroachDB:
# Find your account UUID and check lock status docker exec -e PGPASSWORD=<your_cockroach_password> <cockroach_container> \ cockroach sql --host=localhost --user=<db_user> --database=defaultdb --insecure \ -e "SELECT uuid, failed_login_attempts FROM global_account.account;" # Reset the counter docker exec -e PGPASSWORD=<your_cockroach_password> <cockroach_container> \ cockroach sql --host=localhost --user=<db_user> --database=defaultdb --insecure \ -e "UPDATE global_account.account SET failed_login_attempts = 0 WHERE uuid = '<your_account_uuid>';"
The CockroachDB credentials can be found in your Hulycompose.ymlor viadocker exec <cockroach_container> env | grep COCKROACH.
- Bash wrapper scripts(sourcing.envfiles) may not work reliably when launched by MCP clients on Windows. Prefer setting env vars directly in the MCP config JSON.
- Docker pulls over SSHmay fail on Windows due to credential manager issues. Pull images from the server desktop if needed.
This is a web browser that enables your coding agent, such as Claude Code, to visit websites on your behalf and assist you in identifying bugs or creating UI test cases.
A development management tool for project planning, task management, and development workflows.
A server for managing sequential development tasks with configurable rules using external .mdc files.
Project management inside every AI coding tool — plans what's next, tracks every decision, stops drift.
Facilitates software development planning through an interactive and structured approach.
A tool for structured software development planning, helping to break down projects into tasks and track progress.
Keep teams & agents coordinated automatically
Connect to the Taskade platform via MCP. Access tasks, projects, workflows, and AI agents in real-time through a unified workspace and API.
The Outcome Backcasting MCP is a strategic planning tool that helps you work backwards from a desired future outcome to identify the specific steps, resources, and dependencies needed to achieve your goals. Unlike traditional forward planning, backcasting starts with your end goal and creates a reverse roadmap to get there.
Interact with the ClickUp API to manage tasks, lists, and spaces, automating project planning and workflows.
Apify-hosted MCP server for ClickUp with 20 tools. Tasks, spaces, folders, lists, views, docs, and custom fields. No local setup needed.](#environment-variables)
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
