Skip to content

Add filtering by epic_id and story_id to get_tasks MCP tool #22

@JanJetze

Description

@JanJetze

Problem

The get_tasks MCP tool currently only supports filtering by status and priority. There's no way to query:

  • Tasks belonging to a specific epic
  • Tasks belonging to a specific story
  • Stories belonging to a specific epic

Current Behavior

// get_tasks parameters
{
  status?: "todo" | "in_progress" | "review" | "done" | "blocked",
  priority?: "P0" | "P1" | "P2" | "P3",
  limit?: number
}

The returned task objects do include epic_id, epic_title, story_id, and story_title fields, but there's no way to filter by them.

Proposed Solution

Add optional filter parameters to get_tasks:

{
  status?: string,
  priority?: string,
  epic_id?: string,    // NEW: filter tasks by epic
  story_id?: string,   // NEW: filter tasks by story
  limit?: number
}

Additionally, consider adding:

  • get_stories tool with optional epic_id filter
  • get_epics tool to list all epics

Use Case

When working on a specific epic (e.g., "Settings Screen Redesign"), I need to see only the tasks and stories related to that epic, not the entire backlog. Currently this requires fetching all tasks and filtering client-side, which is inefficient.

🤖 Generated with Claude Code

Metadata

Metadata

Assignees

No one assigned

    Labels

    enhancementNew feature or request

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions