archive_project
ChatGPTArchive a project and its tasks without deleting them. Archived records remain available for statistics and can be unarchived with unarchive_project.
archive_task
ChatGPTArchive a task without deleting it. Archived tasks remain available for statistics and can be unarchived with unarchive_task.
clear_memories
ChatGPTForget Memories in an explicit scope. scope must be project or all; project requires projectId and confirmation exactly DELETE PROJECT <uuid>, all requires DELETE ALL MY MEMORIES. Never infer a scope.
create_column
ChatGPTCreate an additional board column only when the user explicitly asks to change the project's workflow. By default Herculean uses Backlog, In Progress, Review, and Done; do not add columns just to represent blocked, paused, or future work. Resolve the project name to its current ID before calling.
create_label
ChatGPTCreate a label after checking that an appropriate label does not already exist. Set projectId to a project UUID for project-only use, or omit it for global use.
create_memory
ChatGPTCreate one concise durable Memory containing the premise and conclusion the user wants reused. Use projectId for project scope, keywords for aliases, and provenance=inferred only for a confirmed model inference. Search first to avoid duplicates.
create_project
ChatGPTCreate a project for the authenticated user with the standard Backlog, In Progress, Review, and Done columns already created. Do not separately create columns after project creation. Use this only when the user wants a new project; do not use it to rename an existing project.
create_recurrence
ChatGPTCreate a recurrence series directly or from sourceTaskId. Scheduled series wait for the first interval unless startImmediately is true; completion series copied from a task use that task as their initial occurrence. deadlineOffsetSeconds is measured from the scheduled occurrence for scheduled series, and from task creation for completion-triggered series.
create_resource
ChatGPTCreate a project- or task-scoped external resource reference. Herculean stores the URI only and never dereferences it. Infer kind and MIME type only when obvious from user context or an unambiguous file extension; confirm ambiguous interpretations with the user before calling.
create_task
ChatGPTCreate a task in an existing project and column. 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 rewriting. Resolve project, column, and label names to IDs first; never invent IDs.
delete_column
ChatGPTDelete 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_label
ChatGPTPermanently delete a label and remove it from associated projects and tasks. Use only when the user clearly requests deletion.
delete_recurrence
ChatGPTPermanently 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_resource
ChatGPTPermanently 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_memory
ChatGPTForget 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.
get_memory
ChatGPTFetch one Memory by stable UUID, including its concise statement, keywords, project scope, provenance, enabled state, and timestamps.
get_project
ChatGPTFetch 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.
get_project_dependency_graph
ChatGPTReturn 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.
get_quote_of_the_day
ChatGPTReturn the curated Herculean quote selected for today's local calendar date, including its attribution and source when available. Supply the user's IANA time zone when known; otherwise UTC is used. The New Tab visibility preference affects the New Tab display only and does not block an explicit MCP request.
get_recurrence
ChatGPTFetch 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_resource
ChatGPTFetch one external resource reference by stable UUID, including its URI and metadata. The server never downloads the target.
get_task
ChatGPTFetch 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.
get_version
ChatGPTReturn the deployed Herculean MCP server version and the protocol versions it supports. Use this to verify which server build the connector is reaching.
link_task_dependency
ChatGPTLink a prerequisite task to a dependent task. The prerequisite must be completed before the dependent can be completed; self-links and cycles are rejected.
list_board
ChatGPTUse 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_columns
ChatGPTList 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_labels
ChatGPTList the authenticated user's labels and project scope. A null projectId is global; a project UUID restricts the label to that project.
list_memories
ChatGPTList 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.
list_memory_keywords
ChatGPTLoad 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.
list_projects
ChatGPTUse 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_recurrences
ChatGPTList recurrence series for the authenticated account, including their template, trigger mode, next occurrence, and lifecycle state.
list_resources
ChatGPTList 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_task_dependencies
ChatGPTList the direct prerequisites and follow-up tasks for a task. Relationships are directional and may cross projects within the account.
list_tasks
ChatGPTLegacy 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_recurrence
ChatGPTPause a recurrence series. Paused time is not backfilled on resume.
resume_recurrence
ChatGPTResume a paused recurrence series and reset its next occurrence from now.
search_memories
ChatGPTSearch 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_tasks
ChatGPTUse 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.
send_feedback
ChatGPTSubmit 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.
set_task_checkbox
ChatGPTSet 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.
stop_recurrence
ChatGPTStop future generation for a recurrence series. Existing generated tasks remain unchanged.
unarchive_project
ChatGPTUnarchive an archived project and its archived tasks to normal project views without changing stored content or stable IDs.
unarchive_task
ChatGPTUnarchive an archived task to normal task views without changing stored content or its stable ID.
unlink_task_dependency
ChatGPTRemove a prerequisite relationship between two tasks. This is idempotent and does not delete either task.
update_column
ChatGPTRename 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_label
ChatGPTUpdate 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_memory
ChatGPTUpdate one exact Memory UUID. Only supplied fields change; use enabled=false to disable it and clearProjectId=true to make it global.
update_project
ChatGPTRename or update an existing project. Resolve the project name to its current stable UUID first. Only supplied fields are changed.
update_recurrence
ChatGPTEdit 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_task
ChatGPTUpdate 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.