STACK CHECK DOCS PRICING GET STARTED

// MCP TOOL REFERENCE

F Risk Grade Huly · worst category: Destructive

HULY TOOLS

470 tools from the Huly MCP Server, categorised by risk level.

View the Huly policy →

// ALL 470 HULY TOOLS

READ 213 tools

Read describe_huly_space_type_capabilities Describe one Huly SpaceType by id or exact name in a single read-only call. Returns descriptor metadata, ba... Read detach_tag Detach a generic Huly tag from one raw object collection. Requires targetClass and objectId/objectClass/spa... Read download_attachment Get download URL for an attachment along with file metadata (name, type, size). Read fulltext_search Perform a global fulltext search across all Huly content. Searches issues, documents, messages, and other i... Read get_activity_message Get a single activity message by ID, including subclass metadata when available. Read get_approval_request Read one generic Huly approval Request document by raw request _id. Returns person refs with best-effort co... Read get_attachment Retrieve full details for a Huly attachment including download URL. Read get_board Get one Huly board by board _id or exact board name. Returns board metadata, project type, and card count. Read get_board_card Get one board card. board accepts board _id or exact board name; card accepts card _id, CARD-123, bare numb... Read get_board_common_preference Read the CommonBoardPreference row attached to board.app.Board. Returns present=false when the preference r... Read get_board_saved_view Read one board saved filtered view by FilteredView _id or exact name, scoped to attachedTo = board.app.Boar... Read get_card Retrieve full details for a Huly card including markdown content. Use this to view card content and metadata. Read get_channel Retrieve full details for a Huly channel including topic and member list. Read get_chat_message_attachment Get one file attached directly to a Huly channel message, direct-message message, or thread reply. The atta... Read get_component Retrieve full details for a Huly component. Use this to view component content and metadata. Read get_custom_field_values Read custom field values from a document. Pass the document Read get_detailed_time_report Get detailed time breakdown for a project. Shows total time grouped by issue and by employee. Supports date... Read get_document Retrieve full details for a Huly document including markdown content and a Read get_document_snapshot Get one point-in-time Huly document history snapshot and return markdown content. Resolve the document by t... Read get_drawing Get a drawing by ID. Read get_drive Get one Huly Drive by exact drive id or exact drive name. If an exact name is ambiguous, the error includes... Read get_drive_item Get one Drive folder or file by either exact itemId or path. Provide only one locator. File results include... Read get_event Retrieve full details for a calendar event including description. Use this to view event content and metadata. Read get_filtered_view Get one saved filtered view by FilteredView _id or exact name. Pass attachedTo, such as board:app:Board, wh... Read get_huly_class Read one Huly class/interface/mixin by exact ID and return its inheritance chain plus model attributes. Use... Read get_inventory_category Get one inventory category by ID or exact name. If the name is duplicated under different parents, pass par... Read get_inventory_product Get one inventory product by ID or exact product name. If product names are duplicated, pass category or us... Read get_inventory_product_attachment Get one file attached directly to an inventory product. The attachmentId must belong to the resolved product. Read get_inventory_product_photo Get one photo attached directly to an inventory product. The photoId must belong to the resolved product. Read get_inventory_variant Get one inventory variant by ID, exact variant name, or exact SKU. If the name/SKU is duplicated, pass prod... Read get_issue Retrieve full details for a Huly issue including markdown description. Use this to view issue content, comm... Read get_issue_template Retrieve full details for a Huly issue template including children (sub-task templates). Use this to view t... Read get_lead Retrieve full details for a Huly lead including markdown description, customer name, funnel ID and funnel n... Read get_meeting_minutes Get one meeting notes/transcript record (minutes) by meetingMinutesId, including description when readable. Read get_message_template Retrieve one global Huly message template by template ID or exact title. If a title is ambiguous, pass cate... Read get_milestone Retrieve full details for a Huly milestone. Use this to view milestone content and metadata. Read get_notification Retrieve full details for a notification. Use this to view notification content and metadata. Read get_notification_context Get notification context for an entity. Returns tracking information for a specific object. Read get_office Get one personal office room by roomId, including assigned person and description when readable. Read get_office_floor Get one virtual office floor by floorId. Read get_office_room Get one virtual office room by roomId, including description when readable. Read get_organization Retrieve full details for an organization by ID or exact name when that name is unique - including city, de... Read get_person Retrieve full details for a person including contact channels. Use personId or email to identify the person. Read get_process Get one Huly Process workflow definition by process ID or exact display name. If a name is ambiguous, the t... Read get_project Get full details of a Huly project including its statuses. Returns project name, description, archived flag... Read get_project_type Inspect one Huly tracker project type in a single call. Accepts projectType as ID or display name; when omi... Read get_recruiting_applicant Get one Recruiting applicant by raw _id, APP-<number>, or bare number. Pass vacancy and/or candidate when a... Read get_recruiting_applicant_match Get one read-only generated Recruiting applicant match by raw applicant-match _id. Returns candidate, compl... Read get_recruiting_attachment Get one file attached directly to a Recruiting vacancy, candidate, applicant, or opinion. The attachmentId ... Read get_recruiting_candidate Get one Recruiting candidate by person _id, email, or exact display name. Returns profile fields, skills, a... Read get_recruiting_opinion Get one Recruiting opinion by raw _id, OPE-<number>, or bare number. Pass review to disambiguate. Returns v... Read get_recruiting_review Get one Recruiting review by raw _id, RVE-<number>, bare number, or exact title. Optional candidate/applica... Read get_recruiting_vacancy Get one Recruiting vacancy by raw _id, VCN-<number>, bare number, or exact name. Returns descriptions, type... Read get_regions Get available regions for workspace creation. Returns region codes and display names. Read get_schedule Retrieve one calendar schedule including owner, availability, calendar target, time zone, and room informat... Read get_space Get one generic Huly space by raw space _id or exact space name. Resolution tries _id first, then exact nam... Read get_space_preference Read the low-level Huly SpacePreference record attached to one space. Accepts a space _id or exact name wit... Read get_space_type Get one Huly SpaceType by raw SpaceType _id or exact name, including descriptor metadata, role definitions,... Read get_teamspace Get details for a Huly document teamspace including document count. Finds by name or ID, including archived... Read get_test_case Get a single test case by ID or name within a test project. Read get_test_plan Get test plan details including its items (test cases). Accepts plan ID or name within a project. Read get_test_result Get test result details. Accepts result ID or name. Read get_test_run Get test run details including all results. Accepts run ID or name within a project. Read get_test_suite Get a single test suite by ID or name within a test project. Returns suite details and test case count. Read get_time_report Get time tracking report for a specific Huly issue. Shows total time, estimation, remaining time, and all t... Read get_todo Get one Planner ToDo by raw todoId or by human locator such as issue + title + owner. Returns stable ToDo f... Read get_unread_notification_count Get the count of unread notifications. Read get_user_profile Get the current user Read get_workspace_info Get information about the current workspace including name, URL, region, and settings. Read hide_notification_context Hide or unhide a notification context. Hidden contexts are omitted from list_notification_contexts unless i... Read join_channel Join a non-archived Huly channel as the authenticated account. Idempotent when the account is already a mem... Read leave_channel Leave a non-archived Huly channel as the authenticated account. Idempotent when already absent. Refuses to ... Read list_active_room_info List transient active room occupancy summaries. Read list_active_room_participants List transient active virtual-office participants and positions, optionally filtered by roomId. Read list_activity List activity messages for a Huly issue, document, channel, or raw Huly object. Prefer friendly targets: pr... Read list_activity_filters List configured activity filters in display order. Read list_activity_references List activity references connected to a raw Huly object. Use direction to list references from the object, ... Read list_activity_replies List thread replies on any activity message, not only channel messages. Read list_approval_requests List generic Huly approval Request documents from the published @hcengineering/request SDK package. This is... Read list_associations List Huly association definitions: class-level typed links that define which document classes may be relate... Read list_attached_tags List generic Huly TagReference rows attached to one raw object collection. Requires objectId, objectClass, ... Read list_attachments List attachments on a Huly object (issue, document, etc.). Returns attachments sorted by modification date ... Read list_board_card_labels List board labels attached to one board card. Resolves board by _id/name and card by _id, CARD-123, bare nu... Read list_board_cards List cards on one @hcengineering/board board. board accepts board _id or exact board name; cards are sorted... Read list_board_labels List board label definitions. Board labels are @hcengineering/tags TagElement rows for board cards, with ta... Read list_board_menu_pages Read-only list of board menu page model docs. Optional page filters by MenuPage _id, raw pageId, main/archi... Read list_board_saved_views Read-only list of board saved filtered views. Queries view.class.FilteredView where attachedTo = board.app.... Read list_board_viewlets Read-only list of board card viewlets. Queries view.class.Viewlet with attachTo = board.class.Card and incl... Read list_boards List Huly boards from @hcengineering/board, sorted by name. Boards are task.Project-backed spaces; this is ... Read list_calendars List writable, non-hidden calendars that can be used as create_event or create_recurring_event targets. Use... Read list_card_spaces List all Huly card spaces. Returns card spaces sorted by name. Card spaces are containers for cards. Read list_cards List cards in a Huly card space. Returns cards sorted by modification date (newest first). Supports filteri... Read list_channel_members List members of a Huly channel by channel name or ID. Returns each member account UUID and the workspace di... Read list_channel_messages List messages in a Huly channel. Returns messages sorted by date (newest first). Read list_channels List all Huly channels. Returns channels sorted by name. Supports filtering by archived status. Supports se... Read list_chat_message_attachments List files attached directly to a Huly chat message target. target.kind supports channel_message, dm_messag... Read list_comments List comments on a Huly issue. Returns comments sorted by creation date (oldest first). Read list_components List components in a Huly project. Components organize issues by area/feature. Returns components sorted by... Read list_contact_channel_providers List supported contact channel provider labels for person and organization channel tools. Read list_custom_fields List custom field definitions in the workspace. Returns fields with their labels, types, and owner class in... Read list_device_preferences List readable virtual-office media device preferences. Read list_direct_messages List direct message conversations in Huly. Returns conversations sorted by date (newest first). Read list_dm_messages List messages in a direct-message conversation, newest first. The Read list_document_snapshots List version-history snapshots for one Huly document. A snapshot is a saved point-in-time copy from the doc... Read list_documents List documents in a Huly teamspace. Returns documents sorted by modification date (newest first). Each resu... Read list_drawings List drawings attached to a raw Huly parent object. Read list_drive_file_activity List activity messages for a Drive file resolved by filePath or fileId. Provide only one locator. Returns a... Read list_drive_file_comments List comments on a Drive file resolved by filePath or fileId. Provide only one locator. Returns comments so... Read list_drive_file_versions List versions for a Drive file resolved by file id or file path. Marks the current version and includes blo... Read list_drive_items List children under a folder path in a Drive. Paths are POSIX-like and normalized to absolute; Read list_drives List Huly Drive spaces. When includeArchived is omitted, includeArchived=${DEFAULT_INCLUDE_ARCHIVED}. Use t... Read list_employees List employees (persons who are team members). Returns employees sorted by modification date (newest first). Read list_event_instances List instances of a recurring event. Returns instances sorted by date. Supports filtering by date range. Us... Read list_events List calendar events. Returns events sorted by date. Supports filtering by date range. Read list_external_channel_messages List read-only messages for an external Gmail or Telegram channel by channel name or ID. The limit defaults... Read list_filtered_views List saved filtered views from @hcengineering/view. Use attachedTo to scope by raw app/resource string such... Read list_funnels List all Huly sales funnels (lead pipelines). Returns each funnel Read list_huly_attributes Discover Huly model attributes across the workspace or directly on one class/mixin. Returns attribute IDs, ... Read list_huly_classes Discover Huly model class, interface, and mixin IDs visible in this workspace. Use this before raw-object, ... Read list_huly_domain_index_configurations List read-only Huly domain index configuration records from core.class.DomainIndexConfiguration. Returns ea... Read list_huly_enums Discover Huly enum model documents and their valid values. Use enum IDs from get_huly_class or list_huly_at... Read list_huly_plugin_configurations List read-only Huly plugin configuration records from core.class.PluginConfiguration. Returns plugin id, la... Read list_huly_sequences List read-only Huly sequence counters from core.class.Sequence and core.class.CustomSequence. Returns seque... Read list_inline_comments List inline comment threads from a Huly document. Extracts comments embedded in document content as ProseMi... Read list_inventory_categories List inventory categories sorted by name. Omit parentCategory to search all categories, or pass a parent ca... Read list_inventory_product_activity List activity messages for an inventory product resolved by product ID or exact name. This is read-only aud... Read list_inventory_product_attachments List files attached directly to an inventory product resolved by product ID or exact name. Pass category to... Read list_inventory_product_comments List comments attached directly to an inventory product resolved by product ID or exact name. Returns comme... Read list_inventory_product_photos List photos attached directly to an inventory product resolved by product ID or exact name. Pass category t... Read list_inventory_products List inventory products sorted by name. Optionally scope to category by ID/exact name and filter product na... Read list_inventory_variants List inventory variants/SKUs sorted by name. Optionally scope to product by ID/exact name; category can dis... Read list_issue_relations List all relations of an issue. Returns blockedBy (issues blocking this one), blocks (issues this one block... Read list_issue_templates List issue templates in a Huly project. Templates define reusable issue configurations. Returns templates s... Read list_issues Query Huly issues with optional filters. Returns issues sorted by modification date (newest first). Support... Read list_labels List label/tag definitions in the workspace. Labels are global (not project-scoped). Returns labels for tra... Read list_leads Query Huly leads in a funnel with optional filters. Pass the funnel ID returned by list_funnels, or a funne... Read list_master_tags List master tags (card types) available in a Huly card space. Master tags define the type/schema of cards t... Read list_meeting_minutes List meeting notes/transcript records (minutes) by optional attachment target and created-on range. Read list_mentions List @mentions of the current user in activity messages. Read list_message_template_categories List global Huly message template categories. Categories group reusable message templates across the worksp... Read list_message_template_fields List Huly message template fields/placeholders without executing provider resources or rendering templates.... Read list_message_templates List global Huly message templates. Optionally filter by category ID or exact category name, and search tem... Read list_milestones List milestones in a Huly project. Returns milestones sorted by modification date (newest first). Read list_notification_contexts List notification contexts. Returns contexts sorted by last update timestamp (newest first). Supports filte... Read list_notification_providers List notification providers such as inbox, push, and sound. Use provider IDs from this tool when updating p... Read list_notification_settings List notification provider settings. Returns current notification preferences. Read list_notification_types List notification types. Use type IDs from this tool when updating provider-specific notification type sett... Read list_notifications List inbox notifications. Returns notifications sorted by modification date (newest first). Supports filter... Read list_object_collaborators List notification collaborators on a Huly issue, document, or raw object. Prefer friendly targets: project+... Read list_office_defaults List room-level language, default recording, and default transcription settings. Read list_office_floors List virtual office floors. Read list_office_rooms List virtual office rooms, including access mode, type, floor, floor-plan position/size, language, and reco... Read list_offices List personal office rooms and their assigned people when readable. Read list_organization_channels List contact channels for an organization identified by ID or exact unique organization name. Returns chann... Read list_organization_members List all persons who are members of an organization. Returns each member Read list_organizations List all organizations in the Huly workspace. Returns organizations sorted by modification date (newest fir... Read list_person_channels List contact channels for a person. Person accepts person ID, exact email address, or exact Huly display na... Read list_person_organizations List all organizations that a person is a member of. Provide personId or email. Returns each organization Read list_persons List all persons in the Huly workspace. Returns persons sorted by modification date (newest first). Support... Read list_process_executions List read-only Huly Process workflow executions. Supports filters by process ID/name, card/document ID/titl... Read list_processes List read-only Huly Process workflow definitions. Optionally filter by the master tag/card type that workfl... Read list_project_target_preferences List low-level per-project tracker target preference records. These Huly ProjectTargetPreference records ar... Read list_project_types List Huly tracker project types/workflow templates. Returns ID, display name, descriptor, task type count, ... Read list_projects List all Huly projects. Returns projects sorted by name. Supports filtering by archived status. Read list_reactions List reactions on an activity message. Read list_recruiting_activity List read-only activity messages for a Recruiting vacancy, candidate, applicant, or review target resolved ... Read list_recruiting_applicant_matches List read-only generated Recruiting applicant matches. ApplicantMatch fields are generated by Huly; this to... Read list_recruiting_applicants List Recruiting applicants. Optionally filter by vacancy, candidate, and status. vacancy accepts raw _id/VC... Read list_recruiting_attachments List files attached directly to a Recruiting vacancy, candidate, applicant, or opinion target. Review attac... Read list_recruiting_candidate_skills List skill tag references attached to one Recruiting candidate by person _id, email, or exact name. Read list_recruiting_candidates List persons that already have the Recruiting Candidate mixin. Use set_recruiting_candidate_profile, add_re... Read list_recruiting_comments List comments attached directly to a Recruiting vacancy, candidate, applicant, review, or opinion target. T... Read list_recruiting_opinions List Recruiting opinions for one review. review accepts raw _id, RVE-<number>, bare number, or exact title.... Read list_recruiting_related_issues List tracker issues whose Huly Related Issues entries ( Read list_recruiting_reviews List Recruiting reviews/interviews as stable refs. Filter by candidate, application, date range, title/verd... Read list_recruiting_skills List Recruiting skill tag definitions. Skills are Huly tags scoped to targetClass recruit:mixin:Candidate; ... Read list_recruiting_vacancies List Recruiting vacancies as stable refs. Supports includeArchived, name query, type ID/name, company organ... Read list_recruiting_vacancy_statuses List applicant workflow statuses for one vacancy. vacancy accepts raw _id, VCN-<number>, bare number, or ex... Read list_recruiting_vacancy_types List Huly Recruiting vacancy workflow types. Use the returned type ID or exact type name in create_recruiti... Read list_recurring_events List recurring event definitions. Returns recurring events sorted by modification date (newest first). Read list_related_issue_targets List rules that choose the default destination project for related issues. A spaceRule says related issues ... Read list_relations List concrete Huly relation instances under an association, optionally filtered by source and target docume... Read list_saved_attachments List saved/bookmarked attachments for the current user. Read list_saved_messages List saved/bookmarked activity messages. Read list_schedules List calendar scheduling links/availability schedules. Optional owner accepts an employee/person ID, exact ... Read list_space_permissions List core Huly Permission records for space/workspace access control discovery. Filter by scope, objectClas... Read list_space_preferences List low-level Huly SpacePreference records. These generic preference rows are attached to spaces and the p... Read list_space_types List configured Huly SpaceType records. Returns descriptor id, base class, target class, default members, a... Read list_spaces List generic Huly spaces across modules. When includeArchived is omitted, includeArchived=${DEFAULT_INCLUDE... Read list_statuses List all issue statuses for a Huly project with workflow category and default info. Returns status name, ca... Read list_tag_categories List tag/label categories in the workspace. Categories group labels (e.g., Read list_tags List generic Huly tag definitions for one SDK target class. Use this for SDK-level tags such as recruiting ... Read list_task_types List Huly issue/task types. Optionally filter by projectType ID or display name. Returns task type identity... Read list_teamspaces List all Huly document teamspaces. Returns teamspaces sorted by name. Supports filtering by archived status. Read list_test_cases List test cases in a test project. Optional filters: suite (ID or name), assignee (name or email). Read list_test_plans List test plans in a test management project. Returns plan names and IDs. Requires project ID or name. Read list_test_projects List test management projects. Returns test projects sorted by name. These are separate from tracker projects. Read list_test_results List test results in a test run. Returns result names, statuses, and assignees. Read list_test_runs List test runs in a test management project. Returns run names, IDs, and due dates. Read list_test_suites List test suites in a test project. Accepts project ID or name. Optional parent filter for nested suites. Read list_thread_replies List replies in a message thread. Returns replies sorted by date (oldest first). Read list_time_spend_reports List all time entries across issues. Supports filtering by project and date range. Returns entries sorted b... Read list_todos List Huly Planner ToDos. Empty input returns up to ${DEFAULT_LIMIT} ToDos in planner order with all complet... Read list_user_statuses List Huly user presence records. Returns account UUIDs, online status, and last modified timestamp. Use thi... Read list_viewlets List viewlets from @hcengineering/view model metadata. Use attachTo with a Huly class id such as board:clas... Read list_work_slots List scheduled work slots created by schedule_todo, Huly UI, or other clients. Shows planned time blocks at... Read list_workspace_members List members in the current Huly workspace with their roles. Returns members with account IDs and roles. Read list_workspaces List all workspaces accessible to the current user. Returns workspace summaries sorted by last visit. Read log_time Log time spent on a Huly issue. Records a time entry with optional description. Time value is in minutes. Read make_organization_customer Apply the Customer mixin to an organization so it appears in the Huly Leads > Customers view. Idempotent - ... Read reopen_todo Reopen a completed Planner ToDo by clearing doneOn. Human locators search completed ToDos by default; raw t... Read subscribe_to_object_notifications Subscribe the authenticated account to notifications for a raw Huly object by adding a core collaborator ro... Read unsubscribe_from_object_notifications Unsubscribe the authenticated account from notifications for a raw Huly object by removing its collaborator...

WRITE 179 tools

Write add_activity_reply Add a Markdown reply to any activity message. Write add_approval_request Create a generic Huly approval Request attached to any target document. Provide raw attachedTo and attached... Write add_approval_request_comment Add a plain markdown comment to an approval Request by request _id. This does not approve, reject, cancel, ... Write add_attachment Add an attachment to a Huly object. Provide ONE of: filePath (local file - preferred), fileUrl (fetch from ... Write add_board_card_label Attach a board label to a board card. If label is a new title, creates the board-card label definition firs... Write add_channel_members Idempotently add members to a non-archived Huly channel. Members accept account UUID, exact email, or exact... Write add_chat_message_attachment Attach a file directly to a Huly channel message, direct-message message, or thread reply. Provide filename... Write add_comment Add a comment to a Huly issue. Comment body supports markdown formatting. Write add_document_attachment Add an attachment to a Huly document. Convenience method that finds the document by teamspace and title/ID.... Write add_drive_file_comment Add a Markdown comment to a Drive file resolved by filePath or fileId. Provide only one locator. The commen... Write add_drive_members Idempotently add members to an existing Drive. Members accept account UUIDs, exact emails, or exact person ... Write add_inventory_product_attachment Add a file to an inventory product resolved by product ID or exact name. Provide exactly one of filePath, f... Write add_inventory_product_comment Add a Markdown comment directly to an inventory product resolved by product ID or exact name. Pass category... Write add_inventory_product_photo Add a photo to an inventory product using Huly Write add_issue_attachment Add an attachment to a Huly issue. Convenience method that finds the issue by project and identifier. Provi... Write add_issue_label Add a tag/label to a Huly issue. Creates the tag if it doesn Write add_issue_relation Add a relation between two issues. Relation types: Write add_object_collaborator Subscribe a workspace member to object notifications by adding a core collaborator row. Member can be an ac... Write add_organization_channel Idempotently add a contact channel to an organization identified by ID or exact unique name. Provider label... Write add_organization_member Link a person as a member of an organization. The person appears under the org Write add_person_channel Idempotently add a contact channel to a person. Person accepts person ID, exact email address, or exact Hul... Write add_reaction Add an emoji reaction to an activity message. Write add_recruiting_attachment Attach a file to a Recruiting vacancy, candidate, applicant, or opinion target. Provide exactly one of file... Write add_recruiting_candidate_skill Attach a skill to a candidate. candidate accepts person _id, email, or exact name. skill accepts title or t... Write add_recruiting_comment Add a Markdown comment directly to a Recruiting vacancy, candidate, applicant, review, or opinion target re... Write add_recruiting_related_issue Idempotently add a Huly Related Issues entry ( Write add_space_members Idempotently add members to an existing Huly space. Members accept account UUID, exact email, or exact pers... Write add_space_role_members Idempotently add members to one role on a typed Huly space while preserving all other role assignments. Rol... Write add_template_child Add a child (sub-task) template to an issue template. The child defines default values for sub-issues creat... Write add_test_plan_item Add a test case to a test plan. Resolves test case by ID or name. Optionally assign a person by email or name. Write add_thread_reply Add a reply to a message thread. Reply body supports markdown formatting. Write approve_approval_request Approve an active approval Request as the current Huly user. The current user Write archive_all_notifications Archive all notifications. Returns the count of notifications archived. Write archive_board Archive a Huly board by board _id or exact board name. This hides the board but does not delete cards. Write archive_board_card Archive a board card. card accepts _id, CARD-123, bare number, or exact title scoped to the board. Write archive_channel Archive a Huly channel by channel name or ID. This is reversible with unarchive_channel and is idempotent w... Write archive_notification Archive a notification. Archived notifications are hidden from the main inbox view. Idempotent when already... Write archive_notification_context Archive all inbox notifications in a notification context. Idempotent: returns count 0 when no active notif... Write archive_recruiting_vacancy Archive a Recruiting vacancy by raw _id, VCN-<number>, bare number, or exact name. Write attach_tag Attach a generic Huly tag to one raw object collection. Requires targetClass for the tag definition and obj... Write complete_todo Complete a Planner ToDo by setting doneOn. Huly may trim future work slots and run issue automation when th... Write create_access_link Create a Huly workspace access link. When role is omitted, role=${DEFAULT_ACCESS_LINK_ROLE}. Supports anony... Write create_association Idempotently create one Huly association definition between two non-system classes. Use sourceClass/targetC... Write create_board Create a Huly board. Idempotent by exact active board name; pass projectType by _id or exact name only when... Write create_board_card Create a board card with safe defaults. Resolves kind/status from the board project type, increments the CA... Write create_board_label Create a board label definition for board cards. Idempotent by exact title when one label matches; uses boa... Write create_card Create a new card in a Huly card space. Requires a master tag (card type). Content supports markdown format... Write create_channel Create a new channel in Huly. Returns the created channel ID and name. Write create_component Create a new component in a Huly project. Components help organize issues by area/feature. Returns the crea... Write create_direct_message Open a one-to-one direct-message conversation with a workspace member. The Write create_document Create a new document in a Huly teamspace. Content is markdown and supports native Mermaid diagrams ( Write create_drawing Create a drawing under a raw Huly parent object. Write create_drive Idempotently create a Huly Drive space. If an active Drive with the same exact name already exists, returns... Write create_drive_folder Idempotently create a Drive folder path, creating missing parents like mkdir -p. Returns created=false when... Write create_event Create a new calendar event. Description supports markdown formatting. Optional calendarId targets a specif... Write create_group_direct_message Open a group direct-message conversation with at least two other workspace members. The Write create_inventory_category Create an inventory category. Defaults parentCategory to the Inventory root. Rejects duplicate category nam... Write create_inventory_product Create an inventory product in a category resolved by ID or exact name. Rejects duplicate product names in ... Write create_inventory_variant Create an inventory variant/SKU under a product resolved by ID or exact name. Rejects duplicate variant nam... Write create_issue Create a new issue in a Huly project. Optionally set taskType by ID or display name; it is resolved within ... Write create_issue_from_template Create a new issue from a template. Applies template defaults, allowing overrides for specific fields. If t... Write create_issue_status Add a Huly issue workflow status idempotently by normalized name within a project type and task type scope.... Write create_issue_template Create a new issue template in a Huly project. Templates define default values for new issues. Optionally i... Write create_label Create a new label/tag definition in the workspace. Labels are global and can be attached to any issue. Ret... Write create_milestone Create a new milestone in a Huly project. Returns the created milestone ID and label. Write create_organization Create a new organization in Huly. Optionally add members by person ID or email. Fails if any requested mem... Write create_person Create a new person in Huly. Returns the created person ID. Write create_project Create a new Huly tracker project. Idempotent: returns existing project if one with the same identifier alr... Write create_recruiting_applicant Create an applicant linking one vacancy and candidate. Rejects duplicate vacancy/candidate pairs, increment... Write create_recruiting_opinion Create a Recruiting opinion on one review. Increments the OPE sequence, attaches to the review opinions col... Write create_recruiting_review Create a Recruiting review/interview like the Huly UI: increments RVE sequence, attaches to the candidate r... Write create_recruiting_vacancy Create a Recruiting vacancy like the Huly UI: increments the vacancy sequence, stores fullDescription as ma... Write create_recurring_event Create a new recurring calendar event with RFC5545 RRULE rules. Description supports markdown. Optional cal... Write create_relation Idempotently create one concrete relation between two resolved documents for a writable association. Endpoi... Write create_schedule Create a calendar schedule. Owner accepts an employee/person ID, exact name, or email; calendar can be targ... Write create_tag Create a generic Huly tag definition for one targetClass. Idempotent by targetClass + title. This exposes t... Write create_tag_category Create a new tag/label category. Idempotent: returns existing category if one with the same label and targe... Write create_task_type Add a Huly issue/task type to a project type idempotently by normalized name. Copies required workflow conf... Write create_teamspace Create a new Huly document teamspace. Idempotent: returns existing teamspace if one with the same name exists. Write create_test_case Create a test case attached to a suite. Requires project and suite. Defaults: type=functional, priority=med... Write create_test_plan Create a test plan in a project. Idempotent: returns existing plan if one with the same name exists (create... Write create_test_result Create a test result in a run. Resolves test case by ID or name. Status defaults to Write create_test_run Create a test run in a project. For bulk creation from a plan, use run_test_plan instead. Write create_test_suite Create a test suite in a test project. Idempotent: returns existing suite if one with the same name exists ... Write create_todo Create a Planner ToDo. Omit attachedTo for a personal ToDo, or pass attachedTo.type=issue with project and ... Write create_workspace Create a new Huly workspace. Returns the workspace UUID and URL. Optionally specify a region. Write edit_document Edit an existing Huly document. You may rename with title and/or edit the body. Body editing has two mutual... Write link_document_to_issue Link a Huly document to an issue. The link appears in the issue Write mark_all_notifications_read Mark all unread notifications as read. Returns the count of notifications marked. Write mark_notification_read Mark a notification as read. Idempotent: returns success when the notification is already read. Write mark_notification_unread Mark a notification as unread. Idempotent: returns success when the notification is already unread. Write move_drive_item Move a Drive item, meaning a file or folder, to another existing folder path in the same Drive without rena... Write move_issue Move an issue to a new parent (making it a sub-issue) or to top-level (null). Updates parent/child relation... Write pin_activity_message Pin or unpin an activity message. Idempotent when the pin state already matches. Write pin_attachment Pin or unpin an attachment. Write pin_notification_context Pin or unpin a notification context. Pinned contexts are highlighted in the inbox. Idempotent when the pin ... Write reject_approval_request Reject an active approval Request as the current Huly user and attach the required markdown rejection decis... Write rename_drive_item Rename a Drive item, meaning a file or folder, in its current folder. Idempotent when the title is unchange... Write restore_drive_file_version Restore an existing Drive file version by version id or numeric version. Idempotent when the requested vers... Write save_attachment Save/bookmark an attachment for later reference. Idempotent when already saved. Write save_message Save/bookmark an activity message for later reference. Write schedule_todo Schedule a Planner ToDo by raw todoId or human locator, creating a work slot with ToDo title, description, ... Write send_channel_message Send a message to a Huly channel. Message body supports markdown formatting. Write send_dm_message Send a message to a direct-message conversation. The Write set_conversation_closed Set the authenticated user Write set_conversation_starred Set the authenticated user Write set_custom_field Set a custom field value on a document. Requires the document ID, class, field ID (from list_custom_fields)... Write set_drive_owners Replace owners on an existing Drive. Owners accept account UUIDs, exact emails, or exact person names. By d... Write set_issue_component Set or clear the component on a Huly issue. Pass null for component to clear it. Write set_issue_milestone Set or clear the milestone on a Huly issue. Pass null for milestone to clear it. Write set_recruiting_candidate_profile Create or update the Recruiting Candidate profile mixin on an existing person. candidate accepts person _id... Write set_related_issue_target Set the default destination project for related issues from a space or object class. For space, creates or ... Write set_space_owners Replace owners on an existing Huly space. Owners accept account UUID, exact email, or exact person display ... Write set_space_role_members Replace members assigned to one role on a typed Huly space while preserving all other role assignments. Rol... Write unarchive_board Unarchive a Huly board by board _id or exact board name. Write unarchive_board_card Unarchive a board card. card accepts _id, CARD-123, bare number, or exact title scoped to the board. Write unarchive_channel Unarchive a Huly channel by channel name or ID. Idempotent when the channel is already active. Write unarchive_notification Unarchive a notification so it can appear in active notification lists again. Idempotent when already active. Write unarchive_notification_context Unarchive all archived inbox notifications in a notification context. Idempotent: returns count 0 when no a... Write unarchive_recruiting_vacancy Unarchive a Recruiting vacancy by raw _id, VCN-<number>, bare number, or exact name. Write unlink_document_from_issue Remove a document link from an issue. Idempotent: no-op if the document is not linked. Write update_activity_reply Update a generic activity reply body. Write update_attachment Update attachment metadata (description, pinned status). Write update_board Update a Huly board Write update_board_card Update board card fields: title, markdown description, status, assignee, members, location, cover, startDat... Write update_board_label Update a board label definition by TagElement _id or exact title. At least one of title, color, description... Write update_card Update fields on an existing Huly card. Only provided fields are modified. Content updates support markdown. Write update_channel Update fields on an existing Huly channel. Only provided fields are modified. Write update_channel_message Update a channel message. Only the body can be modified. Write update_chat_message_attachment Update description and/or pinned state for a file attached directly to a Huly channel message, direct-messa... Write update_comment Update an existing comment on a Huly issue. Comment body supports markdown formatting. Write update_component Update fields on an existing Huly component. Only provided fields are modified. Write update_dm_message Update a direct-message message. The Write update_drawing Update drawing content. Pass null content to clear it. Write update_drive Update safe metadata on an existing Drive: name, description, private, archived, or autoJoin. Provide at le... Write update_drive_file_comment Update a comment on a Drive file resolved by filePath or fileId. Provide only one locator. Idempotent when ... Write update_event Update fields on an existing calendar event. Only provided fields are modified. Description updates support... Write update_guest_settings Update workspace guest settings. Control read-only guest access and guest sign-up permissions. Write update_inventory_category Rename and/or move an inventory category. category accepts ID or exact name; pass parentCategory when a nam... Write update_inventory_product Rename and/or move an inventory product. product accepts ID or exact name; pass category when a name may be... Write update_inventory_product_attachment Update description and/or pinned state for a file attached directly to an inventory product. The attachment... Write update_inventory_product_comment Update a comment attached directly to an inventory product. The commentId must belong to the resolved product. Write update_inventory_product_photo Update description and/or pinned state for a photo attached directly to an inventory product. The photoId m... Write update_inventory_variant Rename and/or change the SKU of an inventory variant. variant accepts ID, exact name, or exact SKU; pass pr... Write update_issue Update fields on an existing Huly issue. Optionally set taskType by ID or display name; it is resolved with... Write update_issue_template Update fields on an existing Huly issue template. Only provided fields are modified. Write update_label Update a label/tag definition. Accepts label ID or title. Only provided fields are modified. Write update_member_role Update a workspace member Write update_milestone Update fields on an existing Huly milestone. Only provided fields are modified. Write update_notification_provider_setting Update notification provider setting. Enable or disable notifications for a specific provider. Write update_notification_type_setting Enable or disable one notification type for one provider. Creates the type setting only when the provider h... Write update_organization Update fields on an existing organization identified by ID or exact name when that name is unique. Only pro... Write update_organization_channel Update one contact channel on an organization identified by ID or exact unique name. Identify the channel w... Write update_person Update fields on an existing person. Only provided fields are modified. Write update_person_channel Update one contact channel on a person. Person accepts person ID, exact email, or exact display name. Ident... Write update_project Update a Huly project. Only provided fields are modified. Set description to null to clear it. Write update_recruiting_applicant Update applicant status, assignee, startDate, and/or dueDate. applicant accepts raw _id, APP-<number>, or n... Write update_recruiting_attachment Update description and/or pinned state for a file attached directly to a Recruiting vacancy, candidate, app... Write update_recruiting_comment Update one comment attached directly to a Recruiting vacancy, candidate, applicant, review, or opinion. The... Write update_recruiting_opinion Update a Recruiting opinion value and/or markdown description. opinion accepts raw _id, OPE-<number>, or nu... Write update_recruiting_review Update a Recruiting review. review accepts raw _id, RVE-<number>, number, or exact title; candidate/applica... Write update_recruiting_vacancy Update mutable Recruiting vacancy fields. vacancy accepts raw _id, VCN-<number>, bare number, or exact name... Write update_schedule Update a calendar schedule. Supports owner, title, description, duration, interval, availability, timeZone,... Write update_space Update safe common metadata on an existing Huly space: name, description, private, archived, and autoJoin. ... Write update_tag Update a generic Huly tag definition. The tag argument accepts a tag ID or exact title, resolved within tar... Write update_tag_category Update a tag/label category. Accepts category ID or label name. Only provided fields are modified. Write update_teamspace Update fields on an existing Huly document teamspace. Only provided fields are modified. Set description to... Write update_test_case Update a test case. Accepts test case ID or name. Only provided fields are modified. Set assignee to null t... Write update_test_plan Update a test plan Write update_test_result Update a test result Write update_test_run Update a test run Write update_test_suite Update a test suite. Accepts suite ID or name. Only provided fields are modified. Write update_thread_reply Update a thread reply. Only the body can be modified. Write update_todo Update a Planner ToDo by human locator or raw todoId. Supports title, markdown description, owner, dueDate ... Write update_user_profile Update the current user Write upload_drive_file Upload a file into Drive at a full path including filename. Provide exactly one source: filePath, fileUrl, ... Write upload_drive_file_version Upload a new version for an existing Drive file resolved by file id or file path. Provide exactly one sourc... Write upload_file Upload a file to Huly storage. Provide ONE of: filePath (local file - preferred), fileUrl (fetch from URL),... Write upsert_project_target_preference Create or update the low-level ProjectTargetPreference record for a project. This refreshes usedOn and merg...

DESTRUCTIVE 73 tools

Destructive cancel_approval_request Cancel an active approval Request created by the current Huly user. This is the safe removal-from-workflow ... Destructive cancel_execution Idempotently cancel one Huly Process execution by execution ID. Active executions are marked cancelled; alr... Destructive delete_activity_reply Delete a generic activity reply. Destructive delete_association Idempotently delete one Huly association definition only when no concrete relations reference it. If relati... Destructive delete_attachment Permanently delete an attachment. This action cannot be undone. Destructive delete_board_card Permanently delete an already archived board card using Huly removeCollection. Active cards are rejected; c... Destructive delete_board_label Delete one board label definition by TagElement _id or exact title. This removes the label definition, not ... Destructive delete_card Permanently delete a Huly card. This action cannot be undone. Destructive delete_channel Permanently delete a Huly channel. This action cannot be undone. For reversible channel lifecycle changes, ... Destructive delete_channel_message Permanently delete a channel message. This action cannot be undone. Destructive delete_chat_message_attachment Delete one file attached directly to a Huly channel message, direct-message message, or thread reply. The a... Destructive delete_comment Delete a comment from a Huly issue. This action cannot be undone. Destructive delete_component Permanently delete a Huly component. This action cannot be undone. Destructive delete_dm_message Permanently delete a direct-message message. The Destructive delete_document Permanently delete a Huly document. This action cannot be undone. Destructive delete_drawing Delete a drawing. This action cannot be undone. Destructive delete_drive Permanently delete an empty Huly Drive space. The Drive must contain no files or folders; non-empty Drives ... Destructive delete_drive_file_comment Permanently delete a comment from a Drive file resolved by filePath or fileId. Provide only one locator. Th... Destructive delete_drive_item Permanently delete a Drive item, meaning a file or folder. Files are deleted with their version records. Fo... Destructive delete_event Permanently delete a calendar event. This action cannot be undone. Destructive delete_inventory_category Delete an empty inventory category by ID or exact name. Refuses categories that still contain child categor... Destructive delete_inventory_product Delete an inventory product by ID or exact name. Refuses products with variants, photos, attachments, or co... Destructive delete_inventory_product_attachment Permanently delete a file attached directly to an inventory product. The attachmentId must belong to the re... Destructive delete_inventory_product_comment Permanently delete a comment attached directly to an inventory product. The commentId must belong to the re... Destructive delete_inventory_product_photo Permanently delete a photo attached directly to an inventory product. The photoId must belong to the resolv... Destructive delete_inventory_variant Delete one inventory variant/SKU by ID, exact variant name, or exact SKU. This action does not delete its p... Destructive delete_issue Permanently delete a Huly issue. This action cannot be undone. Destructive delete_issue_template Permanently delete a Huly issue template. This action cannot be undone. Destructive delete_label Permanently delete a label/tag definition. Accepts label ID or title. This action cannot be undone. Destructive delete_milestone Permanently delete a Huly milestone. This action cannot be undone. Destructive delete_notification Permanently delete a notification. This action cannot be undone. Destructive delete_organization Permanently delete an organization identified by ID or exact name when that name is unique. Use with care -... Destructive delete_person Permanently delete a person from Huly. This action cannot be undone. Destructive delete_project Permanently delete a Huly project. All issues, milestones, and components in this project will be orphaned.... Destructive delete_recruiting_applicant Delete an applicant with Huly removeCollection. applicant accepts raw _id, APP-<number>, or number; vacancy... Destructive delete_recruiting_attachment Delete one file attached directly to a Recruiting vacancy, candidate, applicant, or opinion. The attachment... Destructive delete_recruiting_comment Delete one comment attached directly to a Recruiting vacancy, candidate, applicant, review, or opinion. The... Destructive delete_recruiting_opinion Delete a Recruiting opinion with Huly removeCollection. opinion accepts raw _id, OPE-<number>, or number; r... Destructive delete_recruiting_review Delete a Recruiting review with Huly removeCollection. review accepts raw _id, RVE-<number>, number, or exa... Destructive delete_related_issue_space_target Delete the spaceRule that chooses the default destination project for related issues from one space. This o... Destructive delete_relation Idempotently delete one concrete relation by relation ID or by exact association/source/target triple. Trip... Destructive delete_schedule Delete a calendar schedule by scheduleId. Destructive delete_tag Delete a generic Huly tag definition by ID or exact title, resolved within targetClass. This deletes the ta... Destructive delete_tag_category Permanently delete a tag/label category. Accepts category ID or label name. Labels in this category will be... Destructive delete_teamspace Permanently delete a Huly document teamspace. This action cannot be undone. Destructive delete_test_case Permanently delete a test case. Accepts test case ID or name. This action cannot be undone. Destructive delete_test_plan Permanently delete a test plan. This does not delete associated test runs. Cannot be undone. Destructive delete_test_result Permanently delete a test result. Cannot be undone. Destructive delete_test_run Permanently delete a test run. This does not delete associated test results. Cannot be undone. Destructive delete_test_suite Permanently delete a test suite. Accepts suite ID or name. This action cannot be undone. Destructive delete_thread_reply Permanently delete a thread reply. This action cannot be undone. Destructive delete_todo Delete a Planner ToDo. This is destructive; deleting the last open issue ToDo can cause Huly classic issue ... Destructive delete_workspace Permanently delete the current workspace. This action cannot be undone. Use with extreme caution. Destructive preview_deletion Preview the impact of deleting a Huly entity before actually deleting it. Shows affected sub-entities, rela... Destructive remove_board_card_label Detach a board label from one board card. Returns detached=false when the label exists but is not attached ... Destructive remove_channel_members Idempotently remove members from a non-archived Huly channel. Members accept account UUID, exact email, or ... Destructive remove_drive_members Idempotently remove members from an existing Drive. Members accept account UUIDs, exact emails, or exact pe... Destructive remove_issue_label Remove a tag/label from a Huly issue. Detaches the label reference; does not delete the label definition. Destructive remove_issue_relation Remove a relation between two issues. Mirrors add_issue_relation: Destructive remove_object_collaborator Unsubscribe a workspace member from object notifications by removing its collaborator row. Member can be an... Destructive remove_organization_channel Remove one contact channel from an organization identified by ID or exact unique name. Identify the channel... Destructive remove_organization_member Unlink a person from an organization Destructive remove_person_channel Remove one contact channel from a person. Person accepts person ID, exact email, or exact display name. Ide... Destructive remove_reaction Remove an emoji reaction from an activity message. Destructive remove_recruiting_candidate_skill Detach a Recruiting skill from a candidate by skill title or tag ID. Idempotent when the skill is absent. Destructive remove_recruiting_related_issue Idempotently remove a Huly Related Issues entry ( Destructive remove_space_members Idempotently remove members from an existing Huly space. Members accept account UUID, exact email, or exact... Destructive remove_space_role_members Idempotently remove members from one role on a typed Huly space while preserving all other role assignments... Destructive remove_template_child Remove a child (sub-task) template from an issue template by its child ID. Get child IDs from get_issue_tem... Destructive remove_test_plan_item Remove a test case from a test plan by item ID. Get item IDs from get_test_plan. Destructive unsave_attachment Remove an attachment from saved/bookmarks. Destructive unsave_message Remove an activity message from saved/bookmarks. Destructive unschedule_todo Remove ToDo work slots. Pass either workSlotId to remove one slot, locator with scope=all, or locator with ...

EXECUTE 5 tools

Execute render_message_template Render one global Huly message template by template ID or exact title. Substitutes only caller-provided val... Execute run_test_plan Execute a test plan: creates a test run and one test result per plan item. Returns the run ID and count of ... Execute start_process Start a new active Huly Process workflow execution on a card/document. Accepts process ID or exact process ... Execute start_timer Start a client-side timer on a Huly issue. Validates the issue exists and returns a start timestamp. Use lo... Execute stop_timer Stop a client-side timer on a Huly issue. Returns the stop timestamp. Calculate elapsed time from start/sto...

// RUNNING THIS SERVER

The managed route: connect Huly through the PolicyLayer gateway — every tool call above is checked against your policy before it runs, with a full audit log.

DIRECT INSTALL (UNMANAGED) npx -y @firfi/huly-mcp

// FAQ

How many tools does the Huly MCP server have? +

The Huly MCP server exposes 470 tools across 4 categories: Read, Write, Destructive, Execute.

How do I enforce policies on Huly tools? +

Route the Huly server through the PolicyLayer gateway. Define allow, deny, or approval rules per tool in the dashboard; they are enforced on every call before it reaches the server.

What risk categories do Huly tools fall into? +

Huly tools are categorised as Read (213), Write (179), Destructive (73), Execute (5). Each category has a recommended default policy.

Enforce policy on every Huly tool call.

Start from Huly, add the rest of your stack, and see everything your agents can call. Then put policy on all of it.

CHECK YOUR STACK →

Instant setup, no code required.

43,000+ MCP servers and 220,000+ tools scanned and risk-classified.