notion-sync

Query, display, and update Notion database tasks via MCP tools.

1|Updated Feb 16, 2026
One-click install
npx skills add https://github.com/codepresso-dev/codepresso-ai-plugin --skill notion-sync-codepresso-dev
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: notion-sync
Source: https://github.com/codepresso-dev/codepresso-ai-plugin/tree/main/skills/notion-sync
Command: npx skills add https://github.com/codepresso-dev/codepresso-ai-plugin --skill notion-sync-codepresso-dev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Keeping your local work in sync with a Notion task board requires constant context switching: opening Notion, filtering for your tasks, and manually updating statuses. This Skill brings the Notion database directly into your AI session so you can view, filter, update, and create tasks without leaving your workflow. ## Core Features & Use Cases - Task Board Querying: Fetches tasks from a configured Notion database, automatically filtered to your assigned items within a configurable sync window (default 14 days). - Status Updates & Task Creation: Update a task's status through an interactive prompt, or create new tasks that are auto-assigned to your configured Notion user identity. - PR Linking: Optionally attach a detected pull request URL to the corresponding Notion task for traceability. - Use Case: At the start of a work session, ask to see your Notion tasks for the current sprint, pick one to work on, and mark it done when finished — all without opening a browser. ## Quick Start Ask the assistant to sync your Notion tasks and show what is assigned to you this sprint.

Frequently Asked Questions about notion-sync

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

FAQPage Schema
How do I sync Notion tasks with my current project?▼

Run the notion sync command after configuring your Notion API key and database ID through the setup flow. The Skill queries your database via MCP tools, displays tasks in a readable list, and lets you update statuses interactively.

How do I show only my assigned Notion tasks?▼

When your Notion user ID is configured, queries automatically filter by the assignee property using a people filter. To see all tasks instead, explicitly ask to show all tasks and the assignee filter is skipped.

Why does Notion sync return no tasks or fail to connect?▼

Failures usually mean the Notion API key or database ID is missing from the configuration. Run the setup command first to store credentials, and verify your user ID and display name are set for assignee filtering to work.

Can I limit how far back Notion task queries go?▼

Yes, the sync window is controlled by the syncWindowDays config value, which defaults to 14 days to prevent oversized responses. Adjust it in the config or set it to 0 to disable the limit entirely.

Does creating a Notion task assign it to me automatically?▼

Yes, when your user ID is configured, new tasks created through the Skill set the assignee property to your Notion user automatically. Without a configured user ID, tasks are created unassigned.