| 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
-
Find current sprint: Query sprints database with filter:
{ "property": "Sprint status", "status": { "equals": "Current" } }
-
Get sprint ID from the result (e.g., 13d26cc4-e1b1-8108-9fb3-d74429e520c6)
-
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
