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
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.
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.
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 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-DDdueDatestringYYYY-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.
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.
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
ReadRequired 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.
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
WriteRequired 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
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
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.
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 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.
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
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.
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.
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.
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
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.
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.
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 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.
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.
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.
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.
