notion-tasks

name	notion-tasks
description	Query and manage Oak AI squad tasks and sprints in Notion. Use when checking current sprint, finding tasks by status, updating task information, or understanding team priorities and workload.
allowed-tools	mcp__notionApi__API-post-database-query, mcp__notionApi__API-retrieve-a-page, mcp__notionApi__API-get-block-children

Notion Task Management

Setup

Database IDs are stored in config.local.md (not checked into git). See config.local.md.example for the required format.

Finding Current Sprint Tasks

1. Find current sprint: Query sprints database with filter:

   { "property": "Sprint status", "status": { "equals": "Current" } }
   

2. Get sprint ID from the result (e.g., 13d26cc4-e1b1-8108-9fb3-d74429e520c6)

3. Query tasks with filter:

   { "property": "Sprint", "relation": { "contains": "SPRINT_ID" } }
   

Efficient Querying with filter_properties

• Essential fields: ["title", "pPPj", "FH@y", "RIV<", "pIdo"]
  • These map to: Task, Status, Who, Type, ID
• Use filter_properties: Reduces response size significantly
• Page size: Can use 50-100 when filtering properties

Example query:

{
  "database_id": "TASKS_DB_ID",
  "filter": {
    "property": "Sprint",
    "relation": { "contains": "SPRINT_ID" }
  },
  "filter_properties": ["title", "pPPj", "FH@y", "RIV<", "pIdo"],
  "page_size": 50
}

Common Task Filters

• In progress: {"property": "Status", "status": {"equals": "In progress"}}
• Ready tasks: {"property": "Status", "status": {"equals": "Ready"}}
• Ready for review: {"property": "Status", "status": {"equals": "Ready for review"}}
• Current sprint tasks: First get current sprint ID, then filter by Sprint relation

Task Status Meanings

• Ready: Available to pick up and start development
• Backlog: Not ready for development yet, needs planning/refinement
• Candidate: Being evaluated, not ready for development
• Triage: Needs assessment before development
• In progress: Currently being worked on
• Ready for review: Code complete, awaiting review
• Merged: Code merged to main branch
• Done: Task completed
• Blocked: Cannot proceed due to dependencies