Saga MCP

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 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.

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

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

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

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

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

Update a subtask title, status, or sort order.

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

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.

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

Search across note titles and content by keyword.

Delete a note by ID.

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 a reusable task template. Templates define a set of tasks that can be instantiated into any epic. Use {variable} placeholders for dynamic values.

List all available task templates.

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

Delete a task template.

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.

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.

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

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.

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

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.