These 25 tools are implemented by Achievator. Your connection exposes only tools for which every listed OAuth scope is approved. Write access does not include read access; your normal workspace and resource permissions still apply.

Use the tool walkthroughs for practical prompts. Parameter names use camelCase, such as taskId and projectId. IDs are UUIDs returned by search or context tools; never invent them. Dates are YYYY-MM-DD in your calendar. Unknown arguments are rejected. Omit optional fields you are not changing. Only update_task accepts null to clear projectId, startDate or dueDate; content tools reject null values.

Projects and tasks

Find projects and tasks, capture a discussion as a task, and update descriptions, dates and checklists.

search_projects, search_tasks, get_task_context, create_task, update_task, rewrite_task_description

search_projects

Read

Required scopes (all): achievator.projects.read

Find accessible projects by words in their names.

When to use

Before filing work under a named project.

Parameters

querystringrequiredWords from the project name or topic. May be empty to list the most recent projects. Maximum characters: 200.
limitintegerMinimum: 1; Maximum: 25; Default: 10.

Output

workspace, projects and hasMore. Projects contain projectId, title, status and available endeavor, client and due-date details.

Limitations

Searches project names, not descriptions. Results are ranked and capped; narrow the query when hasMore is true. Cannot create or edit projects.

search_tasks

Read

Required scopes (all): achievator.tasks.read

Find accessible tasks by title or description, optionally filtered by project or status.

When to use

Before creating work to avoid duplicates, or to identify a task to read or update.

Parameters

querystringrequiredWords from the task title or description. May be empty to list recent tasks. Maximum characters: 200.
projectIdstringOnly tasks in this project (an id from search_projects).
statusstringValues: TO_DO, IN_PROGRESS, IN_REVIEW, REVISION_REQUIRED, BLOCKED, ON_HOLD, COMPLETED, CANCELLED.
limitintegerMinimum: 1; Maximum: 25; Default: 10.

Output

workspace, tasks and hasMore. Tasks include taskId, title, status, scope and available project, startDate and dueDate.

Limitations

Includes accessible workspace tasks and your own personal tasks. No full description, comment search, date-range filter or page parameter. Results are capped, so do not treat them as a complete task list.

get_task_context

Read

Required scopes (all): achievator.tasks.read

Read a task's current fields, Markdown description, checklist and links.

When to use

After finding a task and before changing its fields, checklist or description.

Parameters

taskIdstringrequiredA task id exactly as returned by search_tasks or create_task.

Output

Task fields, descriptionMarkdown, descriptionRevision, descriptionHasNonTextContent, checklist items with itemId and estimates, links and url.

Limitations

Access follows your existing permissions. Use the current descriptionRevision when replacing existing text.

create_task

Write

Required scopes (all): achievator.tasks.write

Create a task with optional Markdown, project, calendar dates, priority and checklist.

When to use

To capture a discussion as executable work after searching for an existing task.

Parameters

titlestringrequiredShort, specific task title. Minimum characters: 3; Maximum characters: 455.
descriptionstringMarkdown: headings (#-###), paragraphs, bullet/numbered/task lists, **bold**, *italic*, `code`, [links](https://...), > quotes, ``` code blocks. Maximum characters: 20000.
projectIdstringA project id from search_projects. Omit for a personal task.
startDatestringYYYY-MM-DD
dueDatestringYYYY-MM-DD Must not precede the resulting startDate.
prioritystringValues: NO_PRIORITY, LOW, MEDIUM, HIGH, CRITICAL.
checklistarrayUp to 30 { title, estimateMinutes? } items. Title: 1–300 characters; estimateMinutes: whole minutes, 0–10080. Steps stay in their supplied order.
clientRequestIdstringUnique request ID, 1–100 characters. Reuse only for a retry of the same operation. Explicit retry protection lasts 24 hours.

Output

taskId, title, status, dates, checklist, url, changes, created and deduplicated.

Limitations

Omitting projectId creates your own personal task. Cannot assign another user, set custom fields or set a whole-task estimateMinutes. Use checklist estimates or weekly planning for estimates.

update_task

Write

Required scopes (all): achievator.tasks.write

Change selected task fields, append description text and add or update checklist items.

When to use

After get_task_context, to add decisions, reschedule work or change progress.

Parameters

taskIdstringrequiredA task id from search_tasks or create_task.
titlestringMinimum characters: 3; Maximum characters: 455.
statusstringValues: TO_DO, IN_PROGRESS, IN_REVIEW, REVISION_REQUIRED, BLOCKED, ON_HOLD, COMPLETED, CANCELLED.
prioritystringValues: NO_PRIORITY, LOW, MEDIUM, HIGH, CRITICAL.
projectIdstring | nullMove the task to this project; null removes it from its project.
startDatestring | nullYYYY-MM-DD, or null to clear.
dueDatestring | nullYYYY-MM-DD, or null to clear. Must not precede the resulting startDate.
appendToDescriptionstringMarkdown added after the existing description. Existing text is never changed. Maximum characters: 20000.
checklistAddarrayUp to 30 { title, estimateMinutes? } items. Title: 1–300 characters; estimateMinutes: whole minutes, 0–10080. Steps stay in their supplied order.
checklistUpdatearrayUp to 30 { itemId, title?, completed?, estimateMinutes? } items. itemId is required and comes from get_task_context. Title: 1–300 characters; estimateMinutes: whole minutes, 0–10080. Items cannot be deleted.
clientRequestIdstringUnique request ID, 1–100 characters. Reuse only for a retry of the same operation. Explicit retry protection lasts 24 hours.

Output

Updated task details, checklist, url, changes and deduplicated.

Limitations

Omitted fields stay unchanged. Use rewrite_task_description for replacement. Cannot delete tasks or checklist items, assign another user or set a whole-task estimate.

rewrite_task_description

Write

Required scopes (all): achievator.tasks.write

Replace a named description section or the whole task description.

When to use

After reading the task, when you explicitly request a rewrite and appending is insufficient.

Parameters

taskIdstringrequiredA task id from search_tasks or create_task.
modestringrequiredValues: replace_section, replace_all.
markdownstringrequiredThe new Markdown for the section (without its heading) or for the whole description. Minimum characters: 1; Maximum characters: 20000.
sectionHeadingstringRequired for replace_section: the heading text of the section to rewrite. If it does not exist yet it is added. Maximum characters: 200.
expectedRevisionintegerdescriptionRevision from get_task_context. Required when replacing existing text.
clientRequestIdstringUnique request ID, 1–100 characters. Reuse only for a retry of the same operation. Explicit retry protection lasts 24 hours.

Output

Task write result with descriptionRevision, changes and url.

Limitations

Discards replaced text. Stale revisions and replacement of content containing images or embeds are refused. Read again after a conflict; append or edit in Achievator when preservation is needed.

Weekly planning

Review unfinished work and capacity, preview a Weekly Focus and Weekly Wins, then save the plan after approval.

get_weekly_planning_context, preview_weekly_plan, apply_weekly_plan

get_weekly_planning_context

Read

Required scopes (all): achievator.tasks.read, achievator.productivity.read

Read strategy, last week's execution, commitments, candidate tasks and capacity in one call.

When to use

First, whenever planning, reviewing or reshaping the current or next week.

Parameters

targetWeekstringThe week to plan. Rollover and review are relative to it. Values: current, next. Default: current.
maxCandidatesintegerMaximum tasks per candidate list (prioritized, leftovers, relevant backlog). Minimum: 3; Maximum: 30; Default: 12.
projectIdstringA project id from search_projects when the user named a project: its open personal backlog tasks are surfaced as relevant.

Output

strategicContext, previousWeek with requiresReview and executionSummary, currentWeek commitments and capacity, and ranked candidates.

Limitations

Only your own work is planned; delegated tasks do not count. Current Focus is guidance, not a filter. Ask about focused time when capacity is missing or partial. For next-week planning, the current week is the previous week.

preview_weekly_plan

Read

Required scopes (all): achievator.tasks.read, achievator.productivity.read

Check a proposed Weekly Focus, Weekly Wins and task schedule without saving changes.

When to use

After discussing the week and before requesting approval of a substantial plan.

Parameters

targetWeekstringThe week being planned. Must match the week you read with get_weekly_planning_context. Values: current, next. Default: current.
weeklyFocusobject{ title, description? }. Outcome title: 3–300 characters; description: up to 2000. Omit to keep the current focus. Example outcome: Ship the launch page.
tasksarrayUp to 30 items, each with exactly one of taskId or newTask and optional weeklyWin and estimateMinutes. Existing task estimates are preserved; estimateMinutes can fill a missing estimate. newTask requires title; optional fields: description (Markdown), projectId, milestoneId, targetId, priority, estimateMinutes, checklist and allowSimilar. Checklist items use title and optional estimateMinutes. Estimates are whole minutes, 0–10080; set allowSimilar only after confirming genuinely separate work. newTask title: 3–455 characters; description: up to 20000. Priority: NO_PRIORITY, LOW, MEDIUM, HIGH or CRITICAL. A checklist has up to 30 items with titles of 1–300 characters.
weeklyWinsModestringadd keeps the week's existing Weekly Wins and adds the new ones (default, nothing is removed). replace makes the listed wins the only wins; the others stay in the week as regular tasks. Use replace only when the user wants that. Values: add, replace. Default: add.
removeWeeklyWinsarrayTask ids to stop treating as Weekly Wins. They stay scheduled in the week. Shape: [string]. Maximum items: 50.
previousWeekDecisionstringcontinue_focus, carry_tasks_only or start_fresh, using your stated decision. A substantial plan requires this when previousWeek.requiresReview is true. Nothing from last week is deleted or carried forward automatically.

Output

Proposed changes, final wins, tasks to create or move, capacity utilization, warnings, issues, canApply, requiresConfirmation and previewToken.

Limitations

Resolve blocking issues and show every warning. Around five Weekly Wins is guidance. Unknown estimates are unknown effort, not zero. A preview is not a saved plan.

apply_weekly_plan

Write

Required scopes (all): achievator.tasks.read, achievator.tasks.write, achievator.productivity.read

Save an approved plan together: focus, wins, task scheduling and genuinely missing tasks.

When to use

After explicit approval of the exact preview, or a direct small request such as making one task a Weekly Win.

Parameters

targetWeekstringThe week being planned. Must match the week you read with get_weekly_planning_context. Values: current, next. Default: current.
weeklyFocusobject{ title, description? }. Outcome title: 3–300 characters; description: up to 2000. Omit to keep the current focus. Example outcome: Ship the launch page.
tasksarrayUp to 30 items, each with exactly one of taskId or newTask and optional weeklyWin and estimateMinutes. Existing task estimates are preserved; estimateMinutes can fill a missing estimate. newTask requires title; optional fields: description (Markdown), projectId, milestoneId, targetId, priority, estimateMinutes, checklist and allowSimilar. Checklist items use title and optional estimateMinutes. Estimates are whole minutes, 0–10080; set allowSimilar only after confirming genuinely separate work. newTask title: 3–455 characters; description: up to 20000. Priority: NO_PRIORITY, LOW, MEDIUM, HIGH or CRITICAL. A checklist has up to 30 items with titles of 1–300 characters.
weeklyWinsModestringadd keeps the week's existing Weekly Wins and adds the new ones (default, nothing is removed). replace makes the listed wins the only wins; the others stay in the week as regular tasks. Use replace only when the user wants that. Values: add, replace. Default: add.
removeWeeklyWinsarrayTask ids to stop treating as Weekly Wins. They stay scheduled in the week. Shape: [string]. Maximum items: 50.
previousWeekDecisionstringcontinue_focus, carry_tasks_only or start_fresh, using your stated decision. A substantial plan requires this when previousWeek.requiresReview is true. Nothing from last week is deleted or carried forward automatically.
previewTokenstringThe previewToken from preview_weekly_plan for exactly this plan. Required for anything beyond a small direct change. Maximum characters: 200.
userApprovedbooleanrequiredTrue only after the user explicitly approved this plan, or directly asked for exactly this change.
clientRequestIdstringUnique request ID, 1–100 characters. Reuse only for a retry of the same operation. Explicit retry protection lasts 24 hours.

Output

Saved focus and wins, created and moved tasks, changes and deduplicated. Failures include code, message and requiresRefresh.

Limitations

All changes save together or none do. Can replace Weekly Focus text. WEEKLY_PLAN_STALE requires fresh context and a new preview; confirm changed details again. Does not delete tasks or rewrite last week's record.

Productivity reviews

Review recorded time, compare plans with actual activity, and ground future estimates in your history.

get_productivity_review_context

get_productivity_review_context

Read

Required scopes (all): achievator.productivity.read

Read facts about your own recorded time, planning, focus alignment and estimate accuracy.

When to use

For a day, week or month retrospective, or to ground future estimates in recorded history.

Parameters

periodstringrequiredThe period to review, in the user's time zone. Values: today, yesterday, this_week, last_week, this_month, custom.
fromDatestringRequired only with period custom. YYYY-MM-DD, inclusive first day. The inclusive period may cover at most 62 days.
toDatestringRequired only with period custom. YYYY-MM-DD, inclusive last day. The inclusive period may cover at most 62 days.
entryLimitintegerMaximum individual time entries to return (the longest are kept). Totals and distributions always cover every entry. 0 returns none. Minimum: 0; Maximum: 100; Default: 40.

Output

Time totals and distributions, planning, estimate-vs-actual data, estimateCalibration, focusAlignment, untrackedGaps and scheduled sleepTimeBlocks.

Limitations

Read-only and based on recorded activity, not all work. Missing tracking does not prove wasted time or sleep. Historical Daily Wins may be unavailable. Use weekly-planning context for Weekly Focus and rollover decisions.

Notes

Find, read, create and update personal notes or notes attached to existing work.

search_notes, get_note_context, create_note, update_note

search_notes

Read

Required scopes (all): achievator.notes.read

Find notes by title or legacy note text, with locations and pagination.

When to use

Before creating a note, or to identify one to read or edit.

Parameters

querystringrequiredWords to search. An empty string lists recent items. Maximum characters: 200.
pageintegerMinimum: 1; Maximum: 10000; Default: 1. Request the next page when hasMore is true.
limitintegerMinimum: 1; Maximum: 25; Default: 10.
scopestringAll accessible items, or only your own personal items. Values: all, personal. Default: all. This search filter is separate from OAuth permission scopes.

Output

workspace, items with id, title, scope and available location, page and hasMore.

Limitations

Does not search current rich-text bodies. personal searches standalone notes and excludes personal task notes. Workspace-wide listing also needs your normal notes read permission.

get_note_context

Read

Required scopes (all): achievator.notes.read

Read a note's current Markdown content and revision.

When to use

After search_notes and before updating a note.

Parameters

noteIdstringrequiredAn id from search_notes or create_note.

Output

id, title, scope, available location, isPinned, contentMarkdown, contentRevision, contentHasNonTextContent and url.

Limitations

Markdown may omit media or complex formatting. The returned link opens the notes list.

create_note

Write

Required scopes (all): achievator.notes.write

Create a note with Markdown, optionally pinned or attached to existing work.

When to use

To save decisions or meeting notes after searching and choosing a destination.

Parameters

titlestringrequiredShort, specific title. Minimum characters: 1; Maximum characters: 455.
contentstringrequiredRequired nonempty Markdown body, up to 20000 characters. Supports headings, paragraphs, lists, links and code.
isPinnedbooleanDefault: false.
locationobjectShape: { type: project | goal | target | milestone | endeavor | task, id: string }. Omit for a personal item. Use one real parent ID; there are no standalone MCP search tools for goals, targets, milestones or endeavors.
clientRequestIdstringUnique request ID, 1–100 characters. Reuse only for a retry of the same operation. Explicit retry protection lasts 24 hours.

Output

entityType, id, title, contentRevision, created, deduplicated, changes and url.

Limitations

Requires a title and nonempty content. Omit location for a personal note. Task notes inherit their task's scope. Your normal create permissions apply.

update_note

Write

Required scopes (all): achievator.notes.write

Change a note's title or pinned state, or append or replace its body.

When to use

After get_note_context; prefer appending and rewrite only when requested.

Parameters

noteIdstringrequiredAn id from search_notes.
titlestringShort, specific title. Minimum characters: 1; Maximum characters: 455.
isPinnedbooleanOptional field; omit to leave unchanged.
contentobjectShape: { mode: append | replace_all, markdown: string, expectedRevision?: integer }. replace_all requires expectedRevision from the latest context's contentRevision. Empty replacement clears the body; empty append is refused.
clientRequestIdstringUnique request ID, 1–100 characters. Reuse only for a retry of the same operation. Explicit retry protection lasts 24 hours.

Output

Content write result with changes, contentRevision, url and deduplicated.

Limitations

Cannot change location or ownership. Full replacement needs the latest revision and is refused if media or unsupported formatting would be lost. Omitted fields stay unchanged.

Ideas

Capture and develop personal ideas or ideas linked to an existing supported parent.

search_ideas, get_idea_context, create_idea, update_idea

search_ideas

Read

Required scopes (all): achievator.ideas.read

Find accessible ideas by words in their titles.

When to use

Before capturing an idea, or to identify an idea to develop.

Parameters

querystringrequiredWords to search. An empty string lists recent items. Maximum characters: 200.
pageintegerMinimum: 1; Maximum: 10000; Default: 1. Request the next page when hasMore is true.
limitintegerMinimum: 1; Maximum: 25; Default: 10.
scopestringAll accessible items, or only your own personal items. Values: all, personal. Default: all. This search filter is separate from OAuth permission scopes.

Output

workspace, items with id, title, scope and available location, page and hasMore.

Limitations

Does not search descriptions. Workspace-wide listing requires your normal ideas read permission; personal searches your own personal ideas.

get_idea_context

Read

Required scopes (all): achievator.ideas.read

Read an idea's current Markdown description and revision.

When to use

After search_ideas and before editing an idea.

Parameters

ideaIdstringrequiredAn id from search_ideas or create_idea.

Output

id, title, scope, available location, contentMarkdown, contentRevision, contentHasNonTextContent and url.

Limitations

Only accessible workspace and your own personal ideas. The returned link opens the ideas list.

create_idea

Write

Required scopes (all): achievator.ideas.write

Capture an idea with an optional Markdown description.

When to use

To save a possibility for later after searching its title.

Parameters

titlestringrequiredShort, specific title. Minimum characters: 1; Maximum characters: 455.
descriptionstringMarkdown content. Headings, paragraphs, lists, links and code are supported. Maximum characters: 20000.
locationobjectShape: { type: project | goal | target | milestone | endeavor, id: string }. Omit for a personal item. Use one real parent ID; there are no standalone MCP search tools for goals, targets, milestones or endeavors.
clientRequestIdstringUnique request ID, 1–100 characters. Reuse only for a retry of the same operation. Explicit retry protection lasts 24 hours.

Output

entityType, id, title, available contentRevision, created, deduplicated, changes and url.

Limitations

Omit location for a personal idea. Ideas cannot be attached directly to tasks through MCP.

update_idea

Write

Required scopes (all): achievator.ideas.write

Change an idea's title or append or replace its description.

When to use

After get_idea_context, to develop an existing idea.

Parameters

ideaIdstringrequiredAn id from search_ideas.
titlestringShort, specific title. Minimum characters: 1; Maximum characters: 455.
contentobjectShape: { mode: append | replace_all, markdown: string, expectedRevision?: integer }. replace_all requires expectedRevision from the latest context's contentRevision. Empty replacement clears the body; empty append is refused.
clientRequestIdstringUnique request ID, 1–100 characters. Reuse only for a retry of the same operation. Explicit retry protection lasts 24 hours.

Output

Content write result with changes, contentRevision, url and deduplicated.

Limitations

Updates use content even though creation uses description. Cannot change location, ownership or pinned state. Full replacement needs a current revision and representable content.

Documents and pages

Find documents, read their pages, create a document with its first page, and add or update pages and subpages.

search_documents, get_document_context, get_document_page_context, create_document, update_document, create_document_page, update_document_page

search_documents

Read

Required scopes (all): achievator.documents.read

Find documents by document title, summary or page titles.

When to use

Before creating a document, or to find pages to read or edit.

Parameters

querystringrequiredWords to search. An empty string lists recent items. Maximum characters: 200.
pageintegerMinimum: 1; Maximum: 10000; Default: 1. Request the next page when hasMore is true.
limitintegerMinimum: 1; Maximum: 25; Default: 10.
scopestringAll accessible items, or only your own personal items. Values: all, personal. Default: all. This search filter is separate from OAuth permission scopes.

Output

workspace, items with id, title, scope and available location, page and hasMore.

Limitations

Does not search page bodies. Read the page tree, then the selected page's context.

get_document_context

Read

Required scopes (all): achievator.documents.read

Read document metadata, edit permission and the page tree.

When to use

After search_documents, before editing metadata or selecting a page.

Parameters

documentIdstringrequiredAn id from search_documents or create_document.

Output

documentId, title, description, scope, available location, isPinned, canEdit, pages with pageId and parentPageId, and url.

Limitations

Does not return page bodies. Use get_document_page_context for Markdown. Writes check permissions again regardless of canEdit.

get_document_page_context

Read

Required scopes (all): achievator.documents.read

Read one page's Markdown body and revision.

When to use

After choosing a page from document context and before editing its title or body.

Parameters

documentIdstringrequiredId of the document.
pageIdstringrequiredPage id from get_document_context.

Output

documentId, pageId, title, available parentPageId, canEdit, contentMarkdown, contentRevision, contentHasNonTextContent and url.

Limitations

Checks access to both document and page. Markdown may omit media or unsupported formatting; preserve those by appending.

create_document

Write

Required scopes (all): achievator.documents.write

Create a document and its first page in one operation.

When to use

To save a longer brief or specification after searching and choosing its location.

Parameters

titlestringrequiredShort, specific title. Minimum characters: 1; Maximum characters: 455.
descriptionstringShort plain-text summary, separate from the page content. Maximum characters: 2000.
contentstringMarkdown content. Headings, paragraphs, lists, links and code are supported. Maximum characters: 20000.
locationobjectShape: { type: project | goal | target | milestone | endeavor, id: string }. Omit for a personal item. Use one real parent ID; there are no standalone MCP search tools for goals, targets, milestones or endeavors.
clientRequestIdstringUnique request ID, 1–100 characters. Reuse only for a retry of the same operation. Explicit retry protection lasts 24 hours.

Output

Content write result including documentId, pageId, changes and url.

Limitations

Omit location for a personal document. description is a plain-text summary; content is the first page's Markdown. Use create_document_page for additional pages.

update_document

Write

Required scopes (all): achievator.documents.write

Change a document's title, short summary or pinned state.

When to use

After get_document_context, when editing metadata.

Parameters

documentIdstringrequiredAn id from search_documents.
titlestringShort, specific title. Minimum characters: 1; Maximum characters: 455.
descriptionstringShort summary. An empty string clears it. Maximum characters: 2000.
isPinnedbooleanOptional field; omit to leave unchanged.
clientRequestIdstringUnique request ID, 1–100 characters. Reuse only for a retry of the same operation. Explicit retry protection lasts 24 hours.

Output

Document write result with changes and url.

Limitations

Does not edit page bodies, move the document or change ownership or page hierarchy. An empty description clears the summary.

create_document_page

Write

Required scopes (all): achievator.documents.write

Add a page or one level of subpage to an existing document.

When to use

After reading the page tree and checking for duplicate pages.

Parameters

documentIdstringrequiredId from get_document_context.
titlestringrequiredShort, specific title. Minimum characters: 1; Maximum characters: 455.
parentPageIdstringOptional top-level page id within this same document.
contentstringMarkdown content. Headings, paragraphs, lists, links and code are supported. Maximum characters: 20000.
clientRequestIdstringUnique request ID, 1–100 characters. Reuse only for a retry of the same operation. Explicit retry protection lasts 24 hours.

Output

Content write result including documentId, pageId, contentRevision, changes and url.

Limitations

Requires document edit permission. Omit parentPageId for a top-level page. A subpage cannot have another subpage.

update_document_page

Write

Required scopes (all): achievator.documents.write

Change a page's title or append or replace its body.

When to use

After get_document_page_context, to update the exact page selected.

Parameters

documentIdstringrequiredId of the document.
pageIdstringrequiredPage id from get_document_context.
titlestringShort, specific title. Minimum characters: 1; Maximum characters: 455.
contentobjectShape: { mode: append | replace_all, markdown: string, expectedRevision?: integer }. replace_all requires expectedRevision from the latest context's contentRevision. Empty replacement clears the body; empty append is refused.
clientRequestIdstringUnique request ID, 1–100 characters. Reuse only for a retry of the same operation. Explicit retry protection lasts 24 hours.

Output

Content write result including documentId, pageId, contentRevision, changes and url.

Limitations

Cannot move or delete pages. Append preserves media and tables. Full replacement needs the current revision and is refused if formatting cannot be represented safely as Markdown.