Tools Reference
All 23 MCP tools available to your AI assistant.
Session
get_context
Load your full working context in one call — rules, projects, and lists. Call this at the start of every session.
| Parameter | Type | Description |
|---|---|---|
includeTasks | boolean | Also return open tasks (default: false) |
taskFilter | enum | Filter tasks: all, ai, inbox, today, overdue, scheduled |
projectName | string | Scope tasks to a specific project by name |
Projects
create_project
Create a new project, optionally linked to a GitHub repo.
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | yes | Project name |
description | string | no | Project description |
githubOwner | string | no | GitHub repo owner |
githubRepo | string | no | GitHub repo name |
update_project
Update a project's name, description, or GitHub repo link.
archive_project
Archive a project. Lists become uncategorized, tasks move to Inbox.
Lists
create_list
Create a new list. Pass projectName to add it to a project.
| Parameter | Type | Required | Description |
|---|---|---|---|
name | string | yes | List name |
projectName | string | no | Assign to project by name |
description | string | no | List description |
update_list
Edit a list or move it to a different project.
archive_list
Archive a list. Tasks move to Inbox.
Tasks
list_tasks
List tasks with filtering. Shows [has plan] tag for tasks with plans.
| Parameter | Type | Description |
|---|---|---|
listName | string | Filter by list name |
projectName | string | Filter by project name |
smartList | enum | inbox, today, overdue, ai, scheduled, all, done |
assignee | enum | user, claude, or agent |
create_task
Create a task. Automatically sets source='mcp' and logs activity.
| Parameter | Type | Required | Description |
|---|---|---|---|
title | string | yes | Task title |
description | string | no | Task description |
listName | string | no | Target list (auto-creates if missing) |
projectName | string | no | Target project |
priority | enum | no | low, medium, high, urgent |
assignee | enum | no | user, claude, or agent |
plan | string | no | MDX plan content |
dueDate | string | no | ISO date or YYYY-MM-DD |
update_task
Update a task. Identify by id or titleSearch.
complete_task
Mark a task as done. Sets completedAt, logs activity, completes subtasks.
delete_task
Delete a task. Logs activity before deletion.
bulk_create_tasks
Create multiple tasks at once. Each task can have its own plan.
add_note
Append a timestamped note to a task's aiNotes field. Use for progress updates.
set_plan
Write or replace the MDX plan on a task. Pass an empty string to clear.
Rules
create_rule
Create a new instruction rule for your AI agent to follow.
| Parameter | Type | Required | Description |
|---|---|---|---|
content | string | yes | The rule text |
projectName | string | no | Scope to a project |
priority | number | no | Higher = more important |
update_rule
Edit a rule's content, priority, or toggle it on/off.
Activity
log_activity
Record an action (commit, deploy, etc.) in the activity feed.
| Parameter | Type | Required | Description |
|---|---|---|---|
action | enum | yes | created, updated, completed, deleted, moved, commented, linked |
metadata | object | no | Additional context (e.g. commit SHA, file list) |
taskId | string | no | Associated task |
projectName | string | no | Associated project |
get_activity
View the activity timeline. Filter by task, list, or project.
Project Metadata
set_project_meta
Set a key-value metadata pair on a project. Use for storing version numbers, URLs, app identifiers, and other project config.
| Parameter | Type | Required | Description |
|---|---|---|---|
projectName | string | yes | Project name |
key | string | yes | Metadata key |
value | string | yes | Metadata value |
get_project_meta
Read metadata from a project. Returns all key-value pairs or a specific key.
| Parameter | Type | Required | Description |
|---|---|---|---|
projectName | string | yes | Project name |
key | string | no | Specific key to read (omit for all) |
Social
post_to_x
Post a tweet to X (Twitter) via a connected integration.
| Parameter | Type | Required | Description |
|---|---|---|---|
text | string | yes | Tweet text |
projectName | string | no | Use the X integration linked to this project |
schedule_post
Schedule a post for future publishing.
| Parameter | Type | Required | Description |
|---|---|---|---|
text | string | yes | Post text |
scheduledFor | string | yes | ISO date-time for when to publish |
projectName | string | no | Use the integration linked to this project |
Name resolution
All tools support name-based resolution — you never need to look up IDs first:
listName— resolves a list by name, or auto-creates itprojectName— resolves a project by nametitleSearch— finds a task by fuzzy title match (returns ambiguity list if multiple match)