notion-tasks

Query and manage Notion squad tasks and sprints via the Notion API.

31|4|Updated Aug 21, 2024
One-click install
npx skills add https://github.com/oaknational/oak-ai-lesson-assistant --skill notion-tasks
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: notion-tasks
Source: https://github.com/oaknational/oak-ai-lesson-assistant/tree/main/.claude/skills/notion-tasks
Command: npx skills add https://github.com/oaknational/oak-ai-lesson-assistant --skill notion-tasks

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you query and manage Notion squad tasks and sprints, surfacing current work and enabling rapid updates via the Notion API. Database IDs are stored in config.local.md (not checked into git).

Core Features & Use Cases

  • Current sprint tasks: Find current sprint by querying sprints database for status "Current" and obtain the sprint ID.
  • Task filtering: Use filter_properties to reduce response size and fetch essential fields like title, status, assignee, type, and ID.
  • Status meanings: Map statuses such as In progress, Ready, Ready for review, Merged, Done, and Blocked to actionable work states.

Quick Start

Copy config.local.md.example to config.local.md and fill in your Notion database IDs. Then follow the steps:

  1. Find the current sprint by filtering sprints where Sprint status equals "Current".
  2. Retrieve tasks with a Sprint relation that contains the current sprint ID.

Frequently Asked Questions about notion-tasks

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I query tasks from a Notion database using the Notion API?

Query Notion tasks using the Notion API by filtering your tasks database for specific properties like status or assignee. This Skill handles database queries and filter properties to retrieve essential fields such as title, status, and assignee efficiently.

How do I find and manage the current sprint in Notion?

Find your current sprint by querying the sprints database and filtering where Sprint status equals "Current", then use that sprint ID to retrieve related tasks. This Skill automates sprint lookup and task association within Notion.

Can I filter Notion tasks by status and assignee?

Yes, this Skill supports filtering tasks by status, assignee, type, and other properties stored in your Notion database. It maps statuses like In progress, Ready, Ready for review, Merged, Done, and Blocked to actionable work states.

What setup is required to query Notion tasks and sprints?

Copy config.local.md.example to config.local.md and populate it with your Notion database IDs. The Skill then connects via the Notion API to query sprints and tasks without storing credentials in version control.

How do I reduce API response size when fetching Notion tasks?

Use filter_properties to retrieve only essential task fields like title, status, assignee, type, and ID. This Skill optimizes queries to minimize response overhead and improve performance.