makenotion/cursor-notion-plugin

tasks-build

Build a task from a Notion page URL.

View source

How to use

  1. Copy the installation command and review the source package before installing it in your own agent environment.
  2. Check the source document for required tools, credentials and supported hosts.
  3. Describe your input and desired deliverable; review the output against the source material.
npx skills add https://github.com/makenotion/cursor-notion-plugin --skill tasks-build

Before you start

  • Installation does not include a model subscription, API allowance or permission to access your files.
  • Repository stars and installation counts describe activity, not an independent quality or security test.
Original skill document

Rendered from the source repository. Headings, examples, code, tables, links, and referenced images are preserved.

Build Task from Notion

Build a task that is tracked in Notion. The user may be watching the Notion board, so all feedback should be sent through Notion.

Input

The user provides a Notion task URL.

Workflow

1. Fetch the task details

Use the Notion MCP tools to:

  • Get the page content including title, description, and any relevant properties
  • Look for acceptance criteria, requirements, or specifications
  • Read any linked pages or references if needed

2. Mark in progress

  • Change the status of the task to "In progress"
  • Update the "Agent status" field (if present) to contain a short description: an emoji followed by a word like "Starting..." or "Working..."

3. Build it

  • Work on the task per the specification. If this is a codebase, implement the code changes.
  • At each step, update the "Agent status" field to explain what's currently happening, so the user can see progress. Keep it brief: a relevant emoji followed by a few words. Examples: "Searching relevant files...", "Updating color scheme...", "Running tests..."
  • If you need user input to clarify the spec or answer questions, add a comment to the task prefixed with "Message from AI:" and set any "Agent blocked" field to true.

4. Update the task status

Once complete:

  • Update the task status in Notion to "Done"
  • If you made a code change, consider using the tasks-explain-diff skill to generate documentation
  • Add a final comment summarizing the results

Notes

  • If the URL is invalid or inaccessible, ask the user to verify the URL and their Notion connection
  • If requirements are unclear, ask clarifying questions before implementing

Related by task