Show current user info, available scopes, and linked project context.

Show the project linked to the current working directory. If no project is linked, automatically lists available projects so the user can choose one to connect.

Link the current directory to a TaskHub project. Subsequent task operations will default to this project. Use project ID, slug, or systemCode to identify the project.

Search any entity by its systemCode (e.g. TSK-260218-A3K7, ORG-260218-B2C3, PRJ-260218-D4F1). Returns the entity type and details.

List your organizations.

Create a new organization.

List members of an organization.

Invite a user to an organization by email.

List projects. Optionally filter by organization or personal projects.

Get detailed information about a project, including members, statuses, and modules.

Create a new project. Specify organizationId for org project, or omit for personal project.

Invite a user to a project by email.

List members of a project with their roles and user IDs. Useful for finding user IDs when assigning tasks. Auto-detects project from .taskhub.json if not specified.

Map a subdirectory to an existing TaskHub project (sub-project). Adds the mapping to .taskhub.json. If the project does not exist, creates it as a child of the root project.

Remove a subdirectory mapping from .taskhub.json. Does NOT delete the project from TaskHub.

List available task statuses for a project or global statuses for daily tasks. IMPORTANT: Call this tool BEFORE creating or updating tasks so you know valid statusId values. Returns each status with its id, name, and flags (DEFAULT = auto-assigned to new tasks, COMPLETED = marks task as done).

List tasks with filters. Without explicit projectId, uses the project linked to the current directory. Supports filtering by status, type, assignee, and pagination.

Get tasks assigned to or created by me.

Get daily tasks for a specific date (defaults to today).

Get full details of a single task. Accepts UUID, systemCode (TSK-XXXXXX-XXXX), or a search term to find by title. Examples: taskhub_task_get({identifier: "TSK-260218-B0F3"}) or taskhub_task_get({identifier: "login"}).

Create a new task. IMPORTANT: Before calling this tool, ALWAYS ask the user to confirm: (1) whether this is a "project" task or a "daily" routine task, and (2) confirm the linked project context. When a project is linked via .taskhub.json, ALL tasks (project and daily) are associated to it by default. Only omit projectId if the user explicitly says the task is not related to any project. If projectId differs from the linked project, a warning is shown.

Update a task. Specify the task ID and any fields to change. TIP: To change status, first call taskhub_statuses to get valid statusId values for the project.

Record one provider-agnostic AI usage execution for a task. Usage must come from the reporting client; this tool never estimates tokens from task content.

Mark a task as completed. Automatically finds the "completed" status for the task's project (using the isCompleted flag) and applies it.

Create a subtask under an existing task.

Delete a task. IMPORTANT: Always confirm with the user before calling this tool. Set confirm=true to execute the deletion. Without confirm=true, it only shows what WOULD be deleted.

List comments on a task.

Add a comment to a task.

List your notifications with unread count.

Mark a notification as read, or mark all notifications as read.

Get a summary of your activity for a specific day (defaults to today). Shows tasks created, completed, comments added, and activity log.