MCP Tools
AbleTime gives your agent four connections, each added to your agent's settings as a server of its own. Time and task tracking at /api/public/v2/mcp records your work and keeps the tasks it belongs to. Project management at /api/public/v2/mcp/pm runs the board: assignment, priority, dependencies, blocking, scheduling, epics and milestones. A combined connection at /api/public/v2/mcp/full carries both, for when you would rather add one server to your agent than two. Reports at /api/public/v2/mcp/reports gives you intelligence reports and changes nothing. This page describes what each tool lets an agent do; the agent learns the technical details from the connection itself.
Every connection works as you, under your own credential: a personal access key, or a connection you approved in the browser. The agent can do only what you can do yourself in AbleTime, and an organization API key cannot connect at all. How to connect is on MCP Authentication.
Time tools
These tools act only on your own entries.
orientation
Tells the agent who it is acting as and what is already going on: recent recorded time, open drafts, active tasks, and current projects with their categories, plus the board stages on the project management and combined connections. It also carries AbleTime's rules for recording work and the starting defaults for the agent's own working document, described on Customizing Behavior. Agents call it at the start of every session.
upsert_entry
Creates a draft time entry: the minutes spent, when the work started, and the task it advanced. Drafts on different tasks may overlap. On the same task, the agent keeps one draft per stretch of work: when a new draft would overlap an existing one, it extends or rewrites the existing draft instead of adding a second. An entry description is limited to 500 characters — it summarizes the work, while the task description carries the detail.
update_entry
Changes an existing draft — usually the open entry as work continues, or an earlier one with the wrong minutes or description.
list_entries
Lists your draft entries from the last 90 days, filtered by kind, task, or date range.
delete_entry
Permanently deletes a draft entry. This cannot be undone — to fix a wrong duration or description, the agent uses update_entry instead.
accept_entry
Accepts a draft, turning it into recorded time. An agent can only accept its own drafts, never anyone else's, and only when you ask it to. Because accepted time is visible to the rest of the organization, this is off until you turn on Agent may commit (accept) my time entries under Agent access on the Privacy & Notifications tab of My Profile.
refresh_feeds
Pulls your registered calendar feeds for one week: what is already in your calendar arrives as your own draft entries, ready to review and accept. Feeds are registered in AbleTime itself.
Project tools
These tools create and change tasks as you.
get_project
Reads one project, and can include its categories, its board stages, its members and its client.
create_task
Creates a task in a project and one of its categories, with its description from the start, and can give it an estimate, tags, an epic, an assignee, a priority, or a task it waits on. New tasks start in backlog or todo.
update_task
Changes a task's title, description, category, estimate, tags or epic. Moving a task between board states is a separate tool, and its dates are set on the project management connection.
get_task
Reads one task in full, including the description the task list leaves out, and can include the task's comment thread, newest first.
list_tasks
Lists tasks, filtered by project, category, epic, board state, or assignee. Archived tasks are included unless filtered out.
set_task_state
Moves a task between board states: backlog and todo either way, doing to done when the work is finished, and back again if it is reopened. A task only reaches doing through time recorded against it, and can only be marked done once that time is on the record. A task that never got any time can still be closed by naming the task in the same project that carried the work, with a note saying so. The same tool restores an archived task: it comes back to doing if it has time, otherwise to todo.
create_comment
Adds a comment to a task: a permanent note on the task's thread, separate from the description and visible to everyone who can see the task. A task that is done or archived takes no new comments.
notify
Sends you a notification in AbleTime: a title, an optional message, and optionally a link to a task. It appears in the Notifications panel of the Productivity Drawer, and by email if you have email notifications on.
description_schema
Gives the agent AbleTime's format for rich task descriptions, for when it writes formatted text rather than markdown.
Finding work and people
These tools help the agent work out where time and tasks belong; none of them changes anything.
search_tasks
Finds tasks by text, matching titles, task references, and tags across every board state.
list_projects
Lists the projects the agent can see, filtered by client or project state, and can include each project's categories.
list_users
Lists who work can be given to. For one project, that is its active members, or everyone when that project's Time Tracking is set to All Personnel. Across the organization, an owner or admin sees everyone; anyone else sees the active members of the projects they share, or everyone when one of those projects has Time Tracking set to All Personnel.
Project management tools
These tools run the board, on the project management and combined connections. Apart from archiving a finished task, they leave done and archived tasks alone.
set_task_assignee
Assigns a task to an active member of its project, or unassigns it.
set_task_priority
Sets or clears a task's priority.
set_task_stage
Moves a task to a stage on its project's board, or clears the stage. The stage must belong to the task's current board state.
set_task_dependency
Makes a task wait on another task in the same project, or clears that link. A chain can't loop back on itself.
set_task_blocked
Marks a task blocked, with a note saying what it is waiting on, or unblocks it and clears the notes.
set_task_locked
Locks a task, or unlocks it. A shift carried down from another task's schedule passes over a locked task and everything chained behind it; moving the locked task directly still moves it.
set_task_schedule
Puts a task on the timeline with a start and end date, or moves it; this needs the Owner, Admin or Manager role. The same shift can be carried onto the tasks that wait on it, and if that would push one of them past a milestone, nothing changes until the agent confirms.
clear_task_schedule
Takes a task off the timeline and removes its link to the task it waited on. A task with recorded time stays where it is.
archive_task
Archives a task as of a date — off the board without deleting it; this needs the Owner, Admin or Manager role. Tasks that were waiting on it stop waiting, and a task with recorded time can only ever be archived, never deleted.
delete_task
Permanently deletes a task created under your account, and only while it is still in backlog or todo with no recorded time. This cannot be undone.
Epic tools
Epics gather tasks under one heading. These tools are on the project management and combined connections; creating, changing, activating, archiving or deleting an epic needs the Owner, Admin or Manager role.
list_epics
Lists epics across every project or within one, filtered by state.
get_epic
Reads one epic in full, including its description.
create_epic
Creates an epic in a project with a title, and optionally a color, description, priority, budget and assignee. A new epic starts in backlog.
update_epic
Changes an epic's title, description, color, priority, budget or assignee. The epic's state is changed with a separate tool.
set_epic_state
Activates an epic, which moves its backlog tasks to todo, or archives it. When archiving, the agent says whether the epic's tasks are set free or archived with it. An archived epic cannot be activated again.
delete_epic
Permanently deletes an epic. It can't be deleted while any task still belongs to it, so the tasks are set free first. This cannot be undone.
Milestone tools
Milestones are the dated markers a project's timeline is planned around. These tools are on the project management and combined connections; organization admins and owners use them across every project, everyone else within the projects they belong to.
list_milestones
Lists a project's milestones.
get_milestone
Reads one milestone in full.
create_milestone
Adds a milestone to a project: a title, the date it lands, and its color, with an optional description, priority, budget, cycle start date, and lock.
update_milestone
Changes a milestone's details.
delete_milestone
Permanently deletes a milestone. This cannot be undone.
Reports
Reports have a connection of their own. Reading a report needs the Owner, Admin or Manager role: an owner or admin gets the whole organization, money included, and a manager gets their own projects without money.
get_report
Builds an intelligence report over a date range and gives you a share link with a six-character code. The agent can narrow it to certain projects or people and ask for particular Report Cards by name or code; name none and you get them all, apart from the origin cards, which come only when you ask for them. The agent also learns what a Report Card cannot show because a rate, cost, capacity, estimate or budget is not set up, so it can tell you. Ask, and it quotes the numbers behind a Report Card. The full walkthrough is on Intelligence Reports with Your Agent, and every Report Card by code is on Intelligence Reports.
Catalog tools
Two lookup tools are on every connection, for the agent to read the tool catalog itself.
tool_schema
Lets the agent look up everything one tool accepts, including the optional details.
full_catalog
Lets the agent look up every tool on the connection, with everything each one accepts, all at once.