io.github.spranab/saga-mcp

View the activity log showing what changed and when. Useful for understanding recent progress or reviewing what happened since the last session.

Add a comment to a task. Comments create a chronological discussion thread — useful for leaving breadcrumbs across sessions.

List all comments on a task in chronological order.

Create an epic within a project. Epics group related tasks into a feature or workstream.

List epics for a project with task counts and completion stats. Optionally filter by status or priority.

Update an epic. Pass only the fields you want to change. Set status to "cancelled" to soft-delete.

Delete a note by ID.

List notes with optional filters. Returns notes sorted by most recent first.

Create or update a note. Notes capture decisions, context, progress, meeting notes, blockers, technical details, or release info. If "id" is provided, updates the existing note; otherwise creates a new one.

Search across note titles and content by keyword.

Create a new project. Projects are the top-level container for all work.

List all projects with epic/task counts and completion percentages. Optionally filter by status.

Update a project. Pass only the fields you want to change. Set status to "archived" to soft-delete.

Create one or more subtasks (checklist items) for a task. Accepts a single title string or an array of title strings for batch creation.

Delete one or more subtasks. Accepts a single ID or array of IDs.

Update a subtask title, status, or sort order.

Update multiple tasks at once. Useful for changing status of several tasks (e.g., mark 3 tasks as done) or reassigning tasks.

Create a task within an epic. Tasks are the primary unit of work.

Get a single task with full details including all subtasks, related notes, comments, and dependencies.

List tasks with optional filters. If no epic_id given, lists across ALL epics. Includes subtask counts and dependency info.

Update a task. Pass only fields to change. Status transitions are automatically logged in the activity log.

Apply a template to create tasks in an epic. Replaces {variable} placeholders with provided values.

Create a reusable task template. Templates define a set of tasks that can be instantiated into any epic. Use {variable} placeholders for dynamic values.

Delete a task template.

List all available task templates.

Get a comprehensive project overview in a single call. Returns: project info, all epics with task counts, overall stats (total/done/blocked/in_progress), recent activity, and recent notes. This is the best first tool to call when starting work on a project.

Export a full project as nested JSON. Includes all epics, tasks, subtasks, comments, dependencies, and related notes. Useful for backup, migration, or sharing.

Import a project from JSON (matching tracker_export format). Creates all entities with new IDs and remaps references. Uses a transaction for atomicity.

Initialize the tracker for a project. If the database is empty, creates a project with the given name. If a project already exists, returns its info.

Search across ALL entities (projects, epics, tasks, notes) by keyword. Returns categorized results.

Show what changed since a given timestamp. Returns aggregated summary with counts by action and entity type, plus highlights of key changes. Call this at the start of a session to understand what happened since the last one.