Agent skill

notion-changes

Query Notion for recent document changes

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/documents/notion-changes

SKILL.md

Notion Changes Skill

Fetches recently edited pages from a Notion workspace.

When to Use

Use this skill when you need to get:

  • Pages created yesterday
  • Pages edited yesterday
  • Who made the changes

How to Use

bash
# Get yesterday's changes (default)
$CLAUDE_CONFIG_DIR/skills/notion-changes/scripts/get-changes.sh

# Get changes for a specific date
$CLAUDE_CONFIG_DIR/skills/notion-changes/scripts/get-changes.sh "2024-12-15"

Arguments

  • date (optional): Specific date in YYYY-MM-DD format. Defaults to yesterday.

Prerequisites

  • NOTION_API_KEY environment variable must be set
  • The Notion integration must have access to the pages you want to query

Output

Results are saved to /tmp/data/notion_changes_[timestamp].json:

json
{
  "date": "2024-12-15",
  "pages_created": [
    {
      "id": "page-id-123",
      "title": "New Document",
      "url": "https://notion.so/...",
      "created_by": "[email protected]",
      "created_time": "2024-12-15T10:30:00Z"
    }
  ],
  "pages_edited": [
    {
      "id": "page-id-456",
      "title": "Existing Document",
      "url": "https://notion.so/...",
      "last_edited_by": "[email protected]",
      "last_edited_time": "2024-12-15T14:00:00Z"
    }
  ]
}

Console output summary:

Notion Changes for 2024-12-15

Pages Created (3):
  - New Document
  - Another Page
  - Meeting Notes

Pages Edited (5):
  - Project Plan
  - Roadmap
  - Team Updates

Error Handling

  • 401 Unauthorized: Check that NOTION_API_KEY is set correctly
  • 403 Forbidden: The integration may not have access to the workspace
  • 429 Rate Limited: Too many requests, try again later

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

Didn't find tool you were looking for?

Be as detailed as possible for better results