Huly MCP
Connects Claude to Huly, the open source project management platform, so you can create and manage issues, search across workspaces, and query projects directly from your AI workflow. Supports both email/password and token authentication, with stdio transport by default and optional HTTP for hosted deployments. Ships with granular toolset filtering if you only want to expose specific capabilities like issue management or search. Includes per-session header auth for multi-tenant scenarios where different users hit the same server instance with different workspace credentials. Useful when you're already running Huly for sprint planning or bug tracking and want to surface that data in Claude without context switching.
- GitHub stars
- 64
- tools
- 20
- auth
- Secret needed
- transport
- STDIO
- env vars
- 10
- last updated
- Nov 11, 2026
Tools
20 toolsPublic tool metadata for what this MCP can expose to an agent.
get_versionReturns the current server version and latest npm version.
Returns the current server version and latest npm version.
No parameter schema in public metadata yet.
get_huly_contextReturns sanitized runtime/configuration context for the current MCP session without connecting to Huly.
Returns sanitized runtime/configuration context for the current MCP session without connecting to Huly.
No parameter schema in public metadata yet.
list_tool_categoriesLists Huly tool categories available through this proxy. Use this first when you need a broad map of capabilities before searching for a specific Huly tool.
Lists Huly tool categories available through this proxy. Use this first when you need a broad map of capabilities before searching for a specific Huly tool.
No parameter schema in public metadata yet.
search_toolsSearches the current proxy-visible Huly tool catalog by tool name, category, description, and parameter names. Returns exact tool names plus required and optional parameter names for single-call follow-up with get_tool_schema or invoke_tool.
Searches the current proxy-visible Huly tool catalog by tool name, category, description, and parameter names. Returns exact tool names plus required and optional parameter names for single-call follow-up with get_tool_schema or invoke_tool.
No parameter schema in public metadata yet.
get_tool_schemaReturns the exact input and output schema for one proxy-visible Huly tool. Use this before invoke_tool when you are not certain about required argument names or result shape.
Returns the exact input and output schema for one proxy-visible Huly tool. Use this before invoke_tool when you are not certain about required argument names or result shape.
No parameter schema in public metadata yet.
invoke_toolInvokes one proxy-visible Huly tool by exact name with its arguments. This tool can call read or write Huly operations; check get_tool_schema and the target tool annotations when safety matters.
Invokes one proxy-visible Huly tool by exact name with its arguments. This tool can call read or write Huly operations; check get_tool_schema and the target tool annotations when safety matters.
No parameter schema in public metadata yet.
list_project_target_preferencesList low-level per-project tracker target preference records. These Huly ProjectTargetPreference records are attached to projects and used by tracker UI/workflows to remember target-related preference props. Omit project to list recent preferences across projects, or pass a pr...
List low-level per-project tracker target preference records. These Huly ProjectTargetPreference records are attached to projects and used by tracker UI/workflows to remember target-related preference props. Omit project to list recent preferences across projects, or pass a pr...
No parameter schema in public metadata yet.
upsert_project_target_preferenceCreate or update the low-level ProjectTargetPreference record for a project. This refreshes usedOn and merges SDK-open target preference props by key. Use for tracker SDK parity or advanced administration; ordinary project and issue workflows usually do not need this tool.
Create or update the low-level ProjectTargetPreference record for a project. This refreshes usedOn and merges SDK-open target preference props by key. Use for tracker SDK parity or advanced administration; ordinary project and issue workflows usually do not need this tool.
No parameter schema in public metadata yet.
list_projectsList all Huly projects. Returns projects sorted by name. Supports filtering by archived status.
List all Huly projects. Returns projects sorted by name. Supports filtering by archived status.
No parameter schema in public metadata yet.
get_projectGet full details of a Huly project including its statuses. Returns project name, description, archived flag, default status, and all available statuses.
Get full details of a Huly project including its statuses. Returns project name, description, archived flag, default status, and all available statuses.
No parameter schema in public metadata yet.
list_statusesList all issue statuses for a Huly project with workflow category and default info. Returns status name, category, and isDefault. Use this to discover valid statuses before creating or updating issues.
List all issue statuses for a Huly project with workflow category and default info. Returns status name, category, and isDefault. Use this to discover valid statuses before creating or updating issues.
No parameter schema in public metadata yet.
create_projectCreate 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.
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.
No parameter schema in public metadata yet.
update_projectUpdate a Huly project. Only provided fields are modified. Set description to null to clear it.
Update a Huly project. Only provided fields are modified. Set description to null to clear it.
No parameter schema in public metadata yet.
delete_projectPermanently delete a Huly project. All issues, milestones, and components in this project will be orphaned. This action cannot be undone.
Permanently delete a Huly project. All issues, milestones, and components in this project will be orphaned. This action cannot be undone.
No parameter schema in public metadata yet.
preview_deletionPreview the impact of deleting a Huly entity before actually deleting it. Shows affected sub-entities, relations, and warnings. Supports issues, projects, components, and milestones. Use this to understand cascade effects before calling a delete operation.
Preview the impact of deleting a Huly entity before actually deleting it. Shows affected sub-entities, relations, and warnings. Supports issues, projects, components, and milestones. Use this to understand cascade effects before calling a delete operation.
No parameter schema in public metadata yet.
list_external_tracker_targetsList external issue-tracker targets mapped to a Huly project. Omit provider to list every provider supported by this server, or pass provider:'github' to list mapped GitHub repositories. Returns each target's provider, kind, stable Huly ID, exact name, enabled state, and an ac...
List external issue-tracker targets mapped to a Huly project. Omit provider to list every provider supported by this server, or pass provider:'github' to list mapped GitHub repositories. Returns each target's provider, kind, stable Huly ID, exact name, enabled state, and an ac...
No parameter schema in public metadata yet.
publish_issue_to_external_trackerRequest publication of an existing Huly issue as a new issue in Huly's configured external tracker. Identify the issue with project and its human identifier (for example, HULY-123); provider currently accepts only 'github'. Select target by stable Huly target ID or exact name,...
Request publication of an existing Huly issue as a new issue in Huly's configured external tracker. Identify the issue with project and its human identifier (for example, HULY-123); provider currently accepts only 'github'. Select target by stable Huly target ID or exact name,...
No parameter schema in public metadata yet.
get_issue_publication_statusRead the Huly-persisted external publication state for an issue identified by project and human issue identifier. Returns not_requested, pending, published, or failed; pending includes the ISO state-change timestamp and elapsed time, while published includes an external URL an...
Read the Huly-persisted external publication state for an issue identified by project and human issue identifier. Returns not_requested, pending, published, or failed; pending includes the ISO state-change timestamp and elapsed time, while published includes an external URL an...
No parameter schema in public metadata yet.
list_componentsList components in a Huly project. Components organize issues by area/feature. Returns components sorted by modification date (newest first).
List components in a Huly project. Components organize issues by area/feature. Returns components sorted by modification date (newest first).
No parameter schema in public metadata yet.
get_componentRetrieve full details for a Huly component. Use this to view component content and metadata.
Retrieve full details for a Huly component. Use this to view component content and metadata.
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
MCP_TRANSPORT*default: stdio-residentLocal MCP runtime: resident shares a backend across compatible clients; stdio uses a separate backend per client.
HULY_URL*Reachable self-hosted or replacement hosted Huly API URL
HULY_EMAIL*Your Huly account email
HULY_PASSWORD*secretYour Huly account password
HULY_WORKSPACE*Huly workspace identifier
HULY_CONNECTION_TIMEOUTConnection timeout in milliseconds. Omit to use the package default.
HULY_TOOL_MODETool exposure mode: auto (default), native, or proxy. Auto keeps exact claude-code native and resolves Codex, Cursor, Windsurf, Copilot, opencode, Claude AI, and unknown clients to proxy mode.
PROXY_OUTPUT_STRICTSet true to make active TOOLSETS / TOOLS a hard allow-list for proxy search, schema lookup, and invocation. Defaults to false.
TOOLSETSComma-separated native Huly tool categories to expose, such as issues,projects,search. If unset with TOOLS, all native tools are exposed.
TOOLSComma-separated exact native Huly tool names to expose in addition to selected TOOLSETS, such as list_documents,create_issue.
Readme
Huly MCP
Huly MCP is a feature-complete MCP server for Huly integration. Published on npm as @firfi/huly-mcp.
Details
- Repository
- github.com/dearlordylord/huly-mcp
- Website
- huly-mcp.dearlordylord.com
- Package
@firfi/huly-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active