| name | taskview |
| description | Conventions for browsing and managing TaskView projects, lists, and tasks through the bundled taskview MCP tools |
Working with TaskView
This plugin connects Claude Code to a TaskView instance through the taskview
MCP server. Use it to let the user view and manage their work without leaving
the terminal.
Terminology
- A goal IS a project — the words are interchangeable. Every tool/param
that says "goal" (
goalId, list_goals, create_goal) means a project. When
the user says "project", use the *_goal tools.
Data model (top → bottom)
- Organization — workspace grouping projects and members.
- Project (goal) —
goalId; list_goals / create_goal / update_goal.
- List (component) — a section inside a project; pass
componentId to
list_tasks to scope to one list, omit it to see all tasks.
- Task — unit of work; supports subtasks, assignees, tags, priority
(1=low, 2=medium, 3=high), deadlines, and dependencies.
Rules that prevent mistakes
- Resolve IDs first, never guess them. Map a name to its numeric id with the
matching
list_* tool (project → list_goals, list → list_lists,
members → list_collaborators_for_goal, columns → list_kanban_columns,
tags → list_tags), then pass that id to create/update/delete tools.
list_tasks is paginated — page is 0-based (~30/page). Keep requesting
the next page until one returns fewer than 30. Completed tasks are hidden
unless showCompleted is set. Use sortBy (date | priority) with
descending to order.- Ask before destructive actions (
delete_*) and before creating duplicates
— check with a list_* call first.
Presenting results
- Show tasks as a concise checklist: status, description, priority, deadline.
- When something is ambiguous (which project/list/org), ask one short question
rather than guessing.
Logging completed work
When the user asks to record what was done, create one top-level task per
finished unit of work in the relevant project (resolve it first), with a clear
description and, if known, the list and priority. Do not bury the summary as a
subtask unless the user asks for that.
