Notion Workspace

Unified API for managing Notion workspace content with a search-first discovery approach. This consolidated MCP combines Search, Pages, Blocks, Comments, and Users endpoints into a single, cohesive integration with aggressive pagination to minimize context usage.

Key features:

1. Search-first approach: Use /v1/search as the primary discovery mechanism before accessing specific resources
2. Aggressive pagination: All list operations default to 10-20 items per page with cursor-based navigation
3. Comprehensive content management: Create, read, update, and delete pages, blocks, and comments
4. Collaboration support: Full comment threading, user mentions, and discussion tracking
5. Rich content support: Text formatting, media blocks, embeds, and nested content structures

Includes:

1. POST /v1/search (Search workspace content - primary discovery)
2. POST /v1/pages (Create pages)
3. GET /v1/pages/{page_id} (Retrieve pages)
4. PATCH /v1/pages/{page_id} (Update pages)
5. GET /v1/blocks/{block_id}/children (List block children with pagination)
6. PATCH /v1/blocks/{block_id}/children (Update block children)
7. GET /v1/blocks/{block_id} (Retrieve blocks)
8. PATCH /v1/blocks/{block_id} (Update blocks)
9. DELETE /v1/blocks/{block_id} (Delete blocks)
10. GET /v1/comments (List comments with pagination)
11. POST /v1/comments (Create comments)
12. PATCH /v1/comments/{comment_id} (Update comments)
13. DELETE /v1/comments/{comment_id} (Delete comments)
14. GET /v1/users (List users with pagination)
15. GET /v1/users/{user_id} (Retrieve user details)