Herculean

Before calling this tool, ensure the target project’s project-scoped memory keyword map was loaded and cached in the current execution/session. If the map is absent, stale, or its cache cannot be verified from this chat, call `list_memory_keywords` with `scope=project` and the target `projectId` first. Do not claim a cache exists unless it is visible in the current context. Reuse a valid recent map without rereading it; refresh after a long gap, memory change, or project switch. Use relevant memories to guide the task write. Create a task in an existing project and column; search first to avoid duplicates. Task descriptions accept Markdown and ordinary GFM checkboxes; Herculean places each stable `hc:cb` ID comment immediately after its checkbox marker and before item text. Other Markdown source is preserved. Use recurrence tools for requested repeating work. Resolve project, column, and label names to IDs first; never invent IDs. The created task includes `webUrl` and `projectWebUrl`.

create_task

Delete a project column only when the user explicitly asks. This cannot be undone. If the column contains any tasks, including archived tasks, moveTasksToColumnId is required and all of its tasks will be moved to that other column in the same project before deletion. Use list_columns to identify valid destination columns; if the user has not specified where the tasks should go, ask before deleting. The project's last remaining column cannot be deleted.

delete_column

Permanently delete a label and remove it from associated projects and tasks. Use only when the user clearly requests deletion.

delete_label

Permanently delete a recurrence series and its occurrence history. Existing tasks created by the series remain on the board, detached from the deleted recurrence. Use only when the user explicitly asks to delete the recurrence.

delete_recurrence

Permanently remove one external resource reference by stable UUID. Herculean deletes only its stored reference and never contacts the referenced URI. Use only when the user clearly asks to remove the resource.

delete_resource

Update a label's name, description, or project scope. Only supplied fields are changed. Resolve project names before using a project UUID; use clearProjectId to make the label global.

update_label

Rename or update an existing project. Resolve the project name to its current stable UUID first. Only supplied fields are changed. Privacy is not configurable through this tool. The updated project includes a direct `webUrl`.

update_project

Update and persist an existing Herculean recurrence series. The resulting series must have a nonblank series title or series description; include one when repairing an older series with both blank. MCP rejects intervalEvery=0 when explicitly supplied, but an update omitting that field preserves an existing web-configured no-delay setting. after_completion waits for the latest task to complete, then waits the configured interval before creating the next task. No delay is available in the web editor, where intervalEvery=0 makes the next occurrence due at completion time. startImmediately only creates the first on_schedule occurrence now. Timing-rule changes recalculate the next occurrence from the latest completion when available; nextOccurrenceAt can only override on_schedule timing. Existing generated tasks are not modified, and template changes affect only future generated tasks. Read the full latest-task description before changing the schedule and preserve any explicit repeat rule. deadlineOffsetSeconds is a separate deadline offset from generated-task creation, not the recurrence delay.

update_recurrence

Update one exact Memory UUID. Memories store reusable knowledge or preferences, not tasks, action items, checklists, reminders, schedules, or task status; use Herculean task tools for those. Only supplied fields change. Use enabled=false to disable it. projectId can assign it to a project, but update_memory cannot remove project scope; create a separate global Memory with create_memory and omit projectId. Set provenance to explicit when the user stated the information, or inferred when the AI inferred it; this describes the information's source, not who created the record.

update_memory

Before calling this tool, ensure the task’s current project-scoped memory keyword map is available. Use `appendDescription` to add an update or information while keeping the existing description; Herculean adds its UTC timestamp and divider. Use `description` only when the user asks to change or replace the full description, and include `descriptionRevision` from the task's latest `updatedAt` so a stale editor cannot overwrite newer work. Do not provide timestamps or divider text for appends. Task descriptions accept Markdown and ordinary GFM checkboxes; Herculean places each stable `hc:cb` ID comment immediately after its checkbox marker and before item text while preserving other Markdown. Use `set_task_checkbox` with the task and checkbox IDs to check or uncheck one item without resending the description. Mark a task complete by moving it to the project's Done column when the user says it is complete. Only supplied fields change. For project moves, provide both destination `projectId` and `columnId`. Resolve project, column, and label IDs first. The updated task includes `webUrl` and `projectWebUrl`; appended updates link directly to the new update.

update_task

Use this as the default read tool for ordinary task questions. It searches the authenticated user's tasks in one call using any combination of text, project ID or name, status/column name, due-date range, completion state and time range, ordering, label name, a numeric priority lower bound, or a high-priority cutoff. Use maxPriority to retrieve assigned priorities from 1 through that value, such as priorities 1 and 2 with maxPriority=2; unprioritized tasks (0) and larger, lower-importance values are excluded. Use completed=true with orderBy=completedAtDesc to get the most recently completed tasks first; completedFrom/completedTo provide an inclusive/exclusive completion-time range. Results are compact by default: stable task, project, and column IDs plus title, project name, status, priority, dueAt, and completedAt. Descriptions are omitted unless includeDescription is true; when included they contain original Markdown source. Returned task records include `webUrl` and `projectWebUrl`.

search_tasks

Forget one exact Memory UUID. This disables and removes it from normal retrieval while retaining the deletion marker. Use only when the user clearly asks to forget it.

forget_memory

Fetch one project by stable ID when its full description, labels, privacy, due date, or archive state is needed. This also works for archived projects. Use list_projects first only when the project ID is not already known. The project includes a direct `webUrl`.

get_project

Fetch one external resource reference by stable UUID, including its URI and metadata. The server never downloads the target.

get_resource

Fetch one Memory by stable UUID, including its concise statement, keywords, project scope, provenance, enabled state, and timestamps.

get_memory

Fetch one task by stable ID when full detail is needed. Returns its complete description as Markdown source, including checkbox IDs in comments immediately after each `[ ]`/`[x]` marker (for example `- [ ] <!-- hc:cb:XXXXXXXX --> item`), plus labels, project, status, priority, dates, and completion data. Use `updatedAt` as `descriptionRevision` when replacing the full description. The task includes `webUrl` and `projectWebUrl`.

get_task

Fetch one complete recurrence series by its stable UUID, including schedule, template, next occurrence, and lifecycle state. For after_completion, the configured interval is measured from completion of the latest task. intervalEvery=0 means no delay for a series configured in the web editor; MCP cannot set zero when creating or explicitly changing the interval.

get_recurrence

Return a project's or the whole account's stored task dependency graph as deterministic Mermaid flowchart text. Omit projectId for the global graph. Includes structured nodes and directed prerequisite-to-dependent edges, with bounded traversal and optional completed, archived, external, or unlinked task inclusion. `webUrl` links to the graph; `projectWebUrl` links to the project, and each task node includes `webUrl` and `projectWebUrl`.

get_project_dependency_graph

List the direct prerequisites and follow-up tasks for a task. Relationships are directional and may cross projects within the account. Each returned task summary includes `webUrl` and `projectWebUrl`.

list_task_dependencies

Broad task listing retained for compatibility but not recommended for regular use. Only call when the user needs absolutely all task data available. Returns full task records and labels for one project or the entire account; descriptions contain original Markdown source. Set includeArchived=true when the user needs historical tasks to inspect or restore. Prefer search_tasks for ordinary task questions and get_task for one task because those tools return smaller, purpose-built responses. Returned task records include `webUrl` and `projectWebUrl`.

list_tasks

List workflow columns and their order. Each new project starts with Backlog, In Progress, Review, and Done: Backlog is captured future work, In Progress is work deliberately active now, Review is performed work awaiting the user's acceptance (especially useful for delegated work), and Done is accepted complete work. Work may move directly from In Progress to Done when no review is needed. Archived completed tasks remain available for historical data and statistics but stay out of routine working views and AI queries. Projects may have additional or different columns for a genuine workflow need; use restraint because each extra state adds a decision and transition to manage. Supply projectId for one project's columns, or omit it to list columns across the board. Resolve a project name before supplying its ID.

list_columns

List the authenticated user's labels and project scope. A null projectId is global; a project UUID restricts the label to that project.

list_labels

List enabled resources for exactly one owner: supply projectId for project resources or taskId for task resources.

list_resources

List recurrence series for the authenticated account, including template, trigger mode, next occurrence, and lifecycle state. For after_completion, the interval is measured from completion of the latest task, and nextOccurrenceAt is when the next task becomes eligible for creation. A web-created series with intervalEvery=0 has no delay and becomes eligible at completion time; MCP cannot set zero when creating or explicitly changing the interval. Filter by projectId or state when useful.

list_recurrences

List enabled Memories from an explicit scope. Use scope=global for only global memories, scope=project with projectId for only that project's memories, or scope=all for all enabled memories on the account. The all result puts global memories before project memories. Omit limit to return every matching record; an optional limit from 1 to 500 bounds the result. Disabled memories are excluded from MCP retrieval. Use search_memories for relevance and ordinary questions.

list_memories

Use this lightweight read to identify or select projects. Returns stable project IDs, names, priority, position, due date, and archive state without descriptions, labels, tasks, or columns. Set includeArchived=true when the user needs historical projects to inspect or restore. Ordinary task questions should use search_tasks, which can resolve projectNames directly. Each project includes a direct `webUrl`.

list_projects

Load a compact keyword map of enabled Memories for chat context. At session start use scope=global to load only global memories. Before project task work use scope=project with that project's projectId (or exact projectName) to load only its memories; combine the cached global and project maps when matching context. Disabled memories are excluded. Omit limit for every matching record; an optional limit from 1 to 500 bounds the result. Use list_memories with scope=all to inspect all enabled account memories, with global memories first. Cache maps in chat context and refresh after long gaps, memory changes, or when the user asks; do not reload every turn.

list_memory_keywords

Pause a recurrence series. Paused time is not backfilled on resume.

pause_recurrence

Remove a prerequisite relationship between two tasks. This is idempotent and does not delete either task.

unlink_task_dependency

Rename or reorder a board column only when the user explicitly asks to change the project workflow. Do not rename or reorder columns as a side effect of task management. Resolve the column to its current stable UUID. Supply at least one of name or position; a position-only update preserves the current name.

update_column

Unarchive an archived project and its archived tasks to normal project views without changing stored content or stable IDs. The archive result includes the project `webUrl`.

unarchive_project

Unarchive an archived task to normal task views without changing stored content or its stable ID. The archive result includes the task `webUrl`.

unarchive_task

Resume a paused recurrence series. For on_schedule, nextOccurrenceAt optionally sets the next occurrence; if omitted, the interval restarts from now. For after_completion, the series waits for the latest task to complete if it is still open.

resume_recurrence

Create one concise durable Memory containing knowledge or a preference the user wants reused. Do not store tasks, action items, checklists, reminders, schedules, or task status in Memory; use Herculean task tools for those. Use projectId for project scope, keywords for aliases, and provenance=inferred only for a confirmed model inference. Search first to avoid duplicate memories.

create_memory

Search relevant enabled Memories in one call. Combine query text, keywords, project UUID, or exact project name. Results include only compact premise-and-conclusion statements; project-scoped and global matches are handled server-side.

search_memories

Submit authenticated-user feedback about Herculean for the operator review queue. Use only when the user explicitly wants to report a bug, idea, usability issue, or general product feedback. The server records MCP context itself; add projectId or taskId only when the feedback directly concerns that record.

send_feedback

Set one GFM Markdown checkbox to an absolute checked state using its `hc:cb` ID from the comment immediately after its `[ ]`/`[x]` marker. Herculean assigns IDs automatically when descriptions are written. Read the task first, use the returned checkbox ID, and set `checked` to true or false; this operation is safe to retry. If the ID is missing, reread the task because its description may have changed.

set_task_checkbox

Permanently stop future generation for a recurrence series. A stopped series cannot be resumed; existing generated tasks remain unchanged.

stop_recurrence

Use only for genuinely broad board inspection or planning that depends on relationships across projects, columns, tasks, and labels. Do not use for ordinary task searches, deadlines, project-specific task lists, or a single task; use search_tasks or get_task instead. Returns the authenticated user's complete board and may be large. Project records include `webUrl`; task records include `webUrl` and `projectWebUrl`.

list_board