Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| taskwarrior_list | List tasks from Taskwarrior with optional filtering.
Use this tool to view tasks, search for specific tasks, or get an overview
of pending work. Supports Taskwarrior filter expressions for powerful querying.
Args:
params: ListTasksInput containing filter, status, limit, and response_format
Returns:
Formatted list of tasks (markdown or JSON based on response_format)
Examples:
- List all pending tasks: params with status="pending"
- List tasks for a project: params with filter="project:work"
- List urgent tasks: params with filter="+urgent"
- List tasks due today: params with filter="due:today"
- List completed tasks: params with status="completed" |
| taskwarrior_add | Create a new task in Taskwarrior.
Use this tool to add new tasks with optional project, priority, due date, and tags.
Args:
params: AddTaskInput containing description and optional attributes
Returns:
Confirmation message with the created task ID
Examples:
- Simple task: params with description="Buy groceries"
- Task with project: params with description="Review PR", project="work"
- High priority task: params with description="Fix bug", priority="H"
- Task with due date: params with description="Submit report", due="friday"
- Task with tags: params with description="Call mom", tags=["personal", "important"] |
| taskwarrior_complete | Mark a task as completed.
Use this tool when a task has been finished and should be marked as done.
Args:
params: CompleteTaskInput containing the task_id to complete
Returns:
Confirmation message
Examples:
- Complete task #5: params with task_id="5"
- Complete by UUID: params with task_id="a1b2c3d4" |
| taskwarrior_modify | Modify an existing task's attributes.
Use this tool to update task description, project, priority, due date, or tags.
Args:
params: ModifyTaskInput containing task_id and attributes to modify
Returns:
Confirmation message with updated task info
Examples:
- Change description: params with task_id="5", description="Updated task name"
- Change project: params with task_id="5", project="personal"
- Set priority: params with task_id="5", priority="H"
- Add tags: params with task_id="5", add_tags=["urgent"]
- Remove due date: params with task_id="5", due="" |
| taskwarrior_delete | Delete a task from Taskwarrior.
Use this tool to remove a task. The task is marked as deleted but can be
recovered with 'undo' if needed.
Args:
params: DeleteTaskInput containing the task_id to delete
Returns:
Confirmation message
Examples:
- Delete task #5: params with task_id="5" |
| taskwarrior_get | Get detailed information about a specific task.
Use this tool to view all attributes and annotations of a single task.
Args:
params: GetTaskInput containing task_id and response_format
Returns:
Detailed task information (markdown or JSON)
Examples:
- Get task #5: params with task_id="5"
- Get task as JSON: params with task_id="5", response_format="json" |
| taskwarrior_annotate | Add an annotation (note) to a task.
Use this tool to add notes, comments, or additional context to a task.
Args:
params: AnnotateTaskInput containing task_id and annotation text
Returns:
Confirmation message
Examples:
- Add note: params with task_id="5", annotation="Discussed with John, needs review" |
| taskwarrior_start | Start working on a task.
Use this tool to indicate you're actively working on a task. This adds the
'active' state to the task.
Args:
params: StartTaskInput containing the task_id to start
Returns:
Confirmation message
Examples:
- Start task #5: params with task_id="5" |
| taskwarrior_stop | Stop working on a task.
Use this tool to indicate you've paused work on a task.
Args:
params: StopTaskInput containing the task_id to stop
Returns:
Confirmation message
Examples:
- Stop task #5: params with task_id="5" |
| taskwarrior_projects | List all projects in Taskwarrior.
Use this tool to see all projects and the number of tasks in each.
Args:
params: ListProjectsInput with response_format
Returns:
List of projects with task counts
Examples:
- List projects: params with response_format="markdown" |
| taskwarrior_tags | List all tags used in Taskwarrior.
Use this tool to see all tags and how many tasks use each tag.
Args:
params: ListTagsInput with response_format
Returns:
List of tags with usage counts
Examples:
- List tags: params with response_format="markdown" |
| taskwarrior_undo | Undo the last Taskwarrior operation.
Use this tool to revert the most recent change to tasks.
Args:
params: UndoInput (no parameters needed)
Returns:
Confirmation message
Examples:
- Undo last action: params with no special values |
| taskwarrior_summary | Get a summary of task statistics.
Use this tool to get an overview of pending tasks, including counts by
project, priority, and urgency.
Returns:
Summary statistics of tasks |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |