Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| NOTION_TOKEN | Yes | Your Notion integration token. Get it from https://www.notion.so/my-integrations → Create integration → Copy token → Share pages with integration |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {} |
| resources | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| pages | Page lifecycle: create, get, get_property, update, move, archive, restore, duplicate. Requires parent_id for create. Returns markdown content for get. |
| databases | Database operations: create, get, query, create_page, update_page, delete_page, create_data_source, update_data_source, update_database, list_templates. Accepts both database_id (from URL) and data_source_id (from workspace search) — auto-resolved. Databases contain data sources with schema and rows. |
| blocks | Block-level content: get, children, append, update, delete. Page IDs are valid block IDs. update only works on text blocks (paragraph, headings, lists, quote, to_do, code). Supports tables, toggles, callouts, images, equations via markdown. |
| users | User info: list, get, me, from_workspace. list requires admin permissions — if it fails, use from_workspace (extracts users from accessible pages). |
| workspace | Workspace: info, search. Search returns pages/databases shared with integration. Use filter.object for type. |
| comments | Comments: list, get, create. Use page_id for new discussion, discussion_id for replies, comment_id for get. |
| content_convert | Convert: markdown-to-blocks, blocks-to-markdown. Most tools handle markdown automatically. |
| file_uploads | File uploads: create, send, complete, retrieve, list. Upload files to Notion (max 20MB direct, multi-part for larger). Use base64 content for send. |
| help | Get full documentation for a tool. Use when compressed descriptions are insufficient. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| Pages Tool Docs | |
| Databases Tool Docs | |
| Blocks Tool Docs | |
| Users Tool Docs | |
| Workspace Tool Docs | |
| Comments Tool Docs | |
| Content Convert Tool Docs | |
| File Uploads Tool Docs |