mh-notion
by mohdalhashemi98-hue
Browser & AutomationBrief
Notion API for creating and managing pages, databases, and blocks.
Description
What This Skill Does
Connects to the Notion API to create, read, update, and query pages, databases, and blocks. Uses the 2025-09-03 API version where databases are called data sources with separate IDs for creation and querying.
Direct API access lets agents read and write Notion content without opening a browser or relying on copy-paste workflows.
When to Use It
- Add new tasks to a Notion project tracker
- Query a database filtered by status or date
- Append meeting notes to an existing page
- Create a new database with custom properties inside a page
- Update page properties like status or due date in bulk
Example Workflow
User asks: add a new task called 'Write release notes' with status Todo to my Tasks database
- 1
Search for the Tasks database using POST /v1/search to get its database_id
- 2
Confirm the correct database is found in search results
- 3
POST /v1/pages with parent.database_id, Name title property set to 'Write release notes', and Status select set to 'Todo'
- 4
Return the new page ID and a confirmation
New page created in the Tasks database with Name 'Write release notes' and Status 'Todo'
Requirements
- NOTION_API_KEY environment variable
- Notion account with an integration created at notion.so/my-integrations
- Target pages or databases shared with the integration via the Notion UI
Installation
clawhub install mohdalhashemi98-hue/mh-notionRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.