Agent skill

notion

Manage Notion pages and databases from the CLI using notion-cli. Create, read, search, and update pages. Query databases, add entries, and manage blocks and properties.

View SKILL.md on GitHub Repository
Stars 100
Forks 8

Install this agent skill to your Project

npx add-skill https://github.com/jjmartres/opencode/tree/main/opencode/skill/notion

SKILL.md

This skill manages Notion workspaces using the notion-cli tool.

Pages

bash
notion-cli page list                        # List recent pages
notion-cli page search "query"              # Search pages by title/content
notion-cli page get <page-id>              # Get page content
notion-cli page create --title "Title" --parent <page-id>
notion-cli page create --title "Title" --content "Body text"
notion-cli page update <page-id> --title "New Title"
notion-cli page delete <page-id>
notion-cli page append <page-id> "Additional content"

Databases

bash
notion-cli db list                          # List all databases
notion-cli db query <db-id>                # Query all entries
notion-cli db query <db-id> --filter "Status=Done"
notion-cli db query <db-id> --sort "Created" --desc
notion-cli db add <db-id> --props "Name=Task,Status=In Progress"
notion-cli db update <page-id> --props "Status=Done"
notion-cli db get <db-id>                  # Get database schema

Blocks

bash
notion-cli block list <page-id>            # List blocks in a page
notion-cli block append <page-id> --type "paragraph" --text "Hello"
notion-cli block append <page-id> --type "todo" --text "Task item"
notion-cli block delete <block-id>

Usage Guidelines

  • Use notion-cli page search to find pages before creating duplicates.
  • Page and database IDs can be found in the Notion URL after the workspace slug.
  • The --props flag uses Key=Value pairs separated by commas.
  • Notion API token must be configured: notion-cli auth or via NOTION_TOKEN env var.

Notes

  • Requires a Notion integration token with appropriate permissions.

Recommended Agent Skills

Expand your agent's capabilities with these related and highly-rated skills.

jjmartres/opencode

file-organizer

Intelligently organizes your files and folders across your computer by understanding context, finding duplicates, suggesting better structures, and automating cleanup tasks. Reduces cognitive load and keeps your digital workspace tidy without manual effort.

100 8
Explore
jjmartres/opencode

Work on Ticket

Fetches Jira ticket details, creates an appropriately named branch, and initiates the task planning workflow. Use when the user says "work on [TICKET_ID]" or similar phrases.

100 8
Explore
jjmartres/opencode

meeting-insights-analyzer

Analyzes meeting transcripts and recordings to uncover behavioral patterns, communication insights, and actionable feedback. Identifies when you avoid conflict, use filler words, dominate conversations, or miss opportunities to listen. Perfect for professionals seeking to improve their communication and leadership skills.

100 8
Explore
jjmartres/opencode

skill-judge

Evaluate Agent Skill design quality against official specifications and best practices. Use when reviewing, auditing, or improving SKILL.md files and skill packages. Provides multi-dimensional scoring and actionable improvement suggestions.

100 8
Explore
jjmartres/opencode

MCP Builder Skill

Guide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).

100 8
Explore
jjmartres/opencode

content-research-writer

Assists in writing high-quality content by conducting research, adding citations, improving hooks, iterating on outlines, and providing real-time feedback on each section. Transforms your writing process from solo effort to collaborative partnership.

100 8
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results