| name | notion-integration |
| description | Read, create, and manage Notion pages, databases, and workspaces. Use when the user mentions Notion, knowledge base, notes, wiki, or document management. |
| version | 1.0.0 |
| license | MIT |
| compatibility | Requires Notion API integration token |
| metadata | {"author":"hermeshub","hermes":{"tags":["notion","knowledge-base","documents","notes"],"category":"productivity"}} |
| required_environment_variables | [{"name":"NOTION_API_KEY","prompt":"Notion Integration Token","help":"Create at https://www.notion.so/my-integrations","required_for":"full functionality"}] |
Notion Integration
Full Notion workspace access for reading, writing, and organizing content.
When to Use
- User mentions Notion, pages, databases, or workspace
- User wants to create or update documentation
- User needs to search their knowledge base
- User wants to sync Notion content to local files
Procedure
- Verify Notion API key is configured
- Search or navigate to the target page/database
- Perform the requested operation (read/write/update)
- Format output for readability
- Confirm changes were applied
Operations
Search
- Search pages: Query by title or content
- List databases: Show all accessible databases
- Filter database: Query with filters and sorts
Pages
- Read page: Extract full content with formatting
- Create page: Build from markdown or structured input
- Update page: Modify blocks, properties, or content
- Archive page: Soft-delete by archiving
Databases
- Query: Filter, sort, and paginate results
- Create entry: Add new row with properties
- Update entry: Modify specific properties
Pitfalls
- Notion API has rate limits (3 requests/second)
- Page content is returned as blocks — reassemble for readability
- Integration must be shared with target pages
- Rich text formatting may not convert perfectly to markdown
Verification
- Confirm page exists and content matches
- Verify database entries have correct properties
- Check that shared pages are accessible
