Huly MCP
Use @firfi/huly-mcp as the source of truth for Huly MCP operations. Prefer its MCP tools over direct Huly API calls, browser automation, or ad hoc SDK code.
Setup Pointer
Do not duplicate setup instructions unless the user asks for them. The canonical installation guide is:
https://github.com/dearlordylord/huly-mcp#installation
It includes Codex, Claude Code, Claude Desktop, VS Code, Cursor, Windsurf, and OpenCode setup. If the user is configuring a client, point them there and help adapt the listed config to their environment.
After setup, verify with read-only calls:
list_projectsget_workspace_info if workspace metadata is neededlist_statuses with a project identifier from list_projects before creating or updating issue statuses
Operating Rules
- Prefer identifier-aware tools and let the MCP server resolve names/IDs where supported.
- Use
preview_deletion before deleting supported tracker entities: issues, projects, components, and milestones. For other delete tools, inspect the target with the corresponding read tool and confirm the user wants deletion.
- Use
list_statuses, list_components, or list_milestones with a project identifier to discover valid project-scoped IDs before writes.
- Use
list_custom_fields for custom-field IDs. Use get_custom_field_values to inspect values already set on a target issue or card.
- Use
list_workspace_members for workspace-member operations such as role updates. For issue assignment, use an assignee email address or display name, not a workspace member account ID.
- Use
fulltext_search first when the user names content but the Huly object type is unclear.
- Keep Huly comments and descriptions in markdown; the MCP server handles Huly markup conversion.
References
Read references/tool-selection.md when choosing among similar Huly MCP tools or planning issue, document, dependency, deletion, search, or toolset-scoping work.
Read references/troubleshooting.md only when setup, auth, transport, or connection behavior is unclear.
1---2name: huly-mcp3description: Use the @firfi/huly-mcp Model Context Protocol server effectively for Huly project-management workflows. Trigger when a user wants to work with Huly issues, projects, documents, comments, milestones, custom fields, test management, activity, workspace data, or when they need concise setup direction for the Huly MCP server.4---56# Huly MCP78Use `@firfi/huly-mcp` as the source of truth for Huly MCP operations. Prefer its MCP tools over direct Huly API calls, browser automation, or ad hoc SDK code.910## Setup Pointer1112Do not duplicate setup instructions unless the user asks for them. The canonical installation guide is:1314https://github.com/dearlordylord/huly-mcp#installation1516It includes Codex, Claude Code, Claude Desktop, VS Code, Cursor, Windsurf, and OpenCode setup. If the user is configuring a client, point them there and help adapt the listed config to their environment.1718After setup, verify with read-only calls:19201. `list_projects`212. `get_workspace_info` if workspace metadata is needed223. `list_statuses` with a project identifier from `list_projects` before creating or updating issue statuses2324## Operating Rules2526- Prefer identifier-aware tools and let the MCP server resolve names/IDs where supported.27- Use `preview_deletion` before deleting supported tracker entities: issues, projects, components, and milestones. For other delete tools, inspect the target with the corresponding read tool and confirm the user wants deletion.28- Use `list_statuses`, `list_components`, or `list_milestones` with a project identifier to discover valid project-scoped IDs before writes.29- Use `list_custom_fields` for custom-field IDs. Use `get_custom_field_values` to inspect values already set on a target issue or card.30- Use `list_workspace_members` for workspace-member operations such as role updates. For issue assignment, use an assignee email address or display name, not a workspace member account ID.31- Use `fulltext_search` first when the user names content but the Huly object type is unclear.32- Keep Huly comments and descriptions in markdown; the MCP server handles Huly markup conversion.3334## References3536Read `references/tool-selection.md` when choosing among similar Huly MCP tools or planning issue, document, dependency, deletion, search, or toolset-scoping work.3738Read `references/troubleshooting.md` only when setup, auth, transport, or connection behavior is unclear.
dearlordylord