Herculean

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.

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

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.

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.

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.

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

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.

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.

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

Fetch one task by stable ID when full detail is needed. Returns its complete description as original Markdown source, labels, project ID and name, column ID and status, priority, position, due date, and completion data. Use search_tasks first only when the task ID is not already known.

Return the deployed Herculean MCP server version and the protocol versions it supports. Use this to verify which server build the connector is reaching.

Link a prerequisite task to a dependent task. The prerequisite must be completed before the dependent can be completed; self-links and cycles are rejected.

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.

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 the authenticated user's labels and project scope. A null projectId is global; a project UUID restricts the label to that project.

List compact enabled Memories for the authenticated user. Supply projectId to include that project's memories and applicable global memories; omit it for global collection inspection. Use search_memories for relevance and ordinary questions.

Load the authenticated user's compact keyword-to-Memory map for MCP context. Use at session start and before planning or materially changing tasks; it includes project-scoped and applicable global statements without dumping unrelated 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.

List recurrence series for the authenticated account, including their template, trigger mode, next occurrence, and lifecycle state.

List enabled external resource references attached to a project or task. Returns metadata and canonical URIs only; Herculean does not fetch or proxy the referenced content.

List the direct prerequisites and follow-up tasks for a task. Relationships are directional and may cross projects within the account.

Legacy broad task listing retained for compatibility. 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.

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

Resume a paused recurrence series and reset its next occurrence from now.

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.

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, label name, and minimum priority. 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. Do not call list_projects first when the user supplied an unambiguous project name.

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.

Stop future generation for a recurrence series. Existing generated tasks remain unchanged.

Unarchive an archived project and its archived tasks to normal project views without changing stored content or stable IDs.

Unarchive an archived task to normal task views without changing stored content or its stable ID.

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

Rename or reorder a board column only when the user explicitly asks to change the project's workflow. Do not rename or reorder columns as a side effect of task management. Resolve the column to its current stable UUID before calling.

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 one exact Memory UUID. Only supplied fields change; use enabled=false to disable it and clearProjectId=true to make it global.

Rename or update an existing project. Resolve the project name to its current stable UUID first. Only supplied fields are changed.

Edit a recurrence series. Timing-rule changes reset the next scheduled occurrence unless nextOccurrenceAt is explicitly supplied; ordinary template changes only affect future generated tasks. deadlineOffsetSeconds is measured from the scheduled occurrence for scheduled series, and from task creation for completion-triggered series.

Update an existing task's fields, labels, ordering, or board placement. Task descriptions use Markdown by default: use headings, lists, emphasis, links, and horizontal separators when they improve readability unless the user asks for plain text. Markdown source is stored without rendering or rewriting. Only supplied fields are changed. Resolve destination and label IDs before calling.