Integration

Notion integration

All-in-one workspace API for notes, docs, wikis, and project management. Create and manage pages, databases, blocks, search content, query databases with filters, and manage workspace users. Perfect for building knowledge management tools, project management integrations, content automation systems, and workspace collaboration platforms.

Connect Notion How integrations work

Ask it in chat

Say what should happen.
The workflow builds itself.

When this happens, do that in Notion.Built from the 34 Notion tools below, on the connection you add once.

Common Notion use cases

renaming database
editing page content
auditing file uploads
renaming data sources
OAuth integration setup
uploading file contents
adding feedback to pages
displaying page comments
building user selector UI
filtering tasks by status

What you can do with Notion

Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.

Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.

Page, 7 operations

create_pageCreate pagePOSTCreates a new Notion page either as a database row or as a child of another page. Set properties for database pages, add content blocks as children, and optionally set icon and cover image. Returns the created page with its new ID.
get_pageGet pageGETRetrieves metadata and properties for a Notion page. Returns page title, icon, cover, parent info, and all database properties if page is in a database. Does not return page content - use get_block_children for that.
move_pageMove pagePOSTMoves a Notion page to a new parent page or data source. Uses POST method to /pages/{page_id}/move. Essential for reorganizing workspace structure.
query_databaseQuery databasePOSTQueries a Notion database with filtering and sorting. Returns pages (rows) matching filter criteria with all property values. Supports complex filters with AND/OR logic, multiple sort keys, and cursor pagination for large databases.
query_data_sourceQuery data sourcePOSTQueries pages from a specific data source. Like query_database but scoped to one data source in multi-source databases.
searchSearchPOSTSearches across all Notion pages and databases accessible to the integration. Filter by object type (page or data_source) and sort by last edited time. Returns matching items with titles, IDs, and metadata. Essential for discovering content withou...
update_pageUpdate pagePATCHUpdates properties of an existing Notion page or database row. Modify property values, archive/unarchive pages, and update icon or cover. Does not modify page content blocks - use block endpoints for that.

Block, 5 operations

append_block_childrenAppend block childrenPATCHAppends new content blocks to a page or parent block. Add paragraphs, headings, lists, toggles, and other block types. New blocks appear at the end of existing content.
delete_blockDelete blockDELETEArchives (deletes) a block from a Notion page. Removes the block and all its children. Can be a content block or an entire page. Operation sets archived=true, can be undone via restore.
get_blockGet blockGETRetrieves a single Notion block by ID. Returns block type, content, and metadata. Blocks are the content elements within pages including paragraphs, headings, lists, toggles, images, and more.
get_block_childrenGet block childrenGETRetrieves all child blocks within a page or parent block. Returns the actual content of a Notion page including paragraphs, headings, lists, and other block types. Supports pagination for pages with many blocks.
update_blockUpdate blockPATCHUpdates the content of an existing Notion block. Modify text, toggle checkboxes, or archive blocks.

File upload, 5 operations

complete_file_uploadComplete file uploadPOSTCompletes a multi-part file upload after all chunks are sent. Required for large files uploaded in parts.
create_file_uploadCreate file uploadPOSTInitiates a file upload to Notion. Returns a file_upload_id for use with send_file_upload. Files expire if not attached within 1 hour.
get_file_uploadGet file uploadGETRetrieves file upload details and status. Check if upload is pending, uploaded, archived, or expired.
list_file_uploadsList file uploadsGETLists all file uploads for the integration. Returns file upload objects with status and metadata. Supports pagination.
send_file_uploadSend file uploadPOSTUploads file contents to Notion. Uses multipart/form-data with file binary under 'file' key. Must call after create_file_upload.

Comment, 3 operations

create_commentCreate commentPOSTCreates a new comment on a Notion page or in an existing discussion thread. Supports rich text content with formatting, mentions, and links.
get_commentGet commentGETRetrieves a specific comment by ID. Returns full comment details including content, author, and timestamps.
list_commentsList commentsGETRetrieves all comments from a Notion page or specific discussion thread. Returns comment content, author, and timestamps with pagination support.

Data source, 3 operations

create_data_sourceCreate data sourcePOSTCreates a data source in a multi-source database. Data sources are sub-collections within databases (API v2025-09-03+).
get_data_sourceGet data sourceGETRetrieves a data source by ID. Returns title, description, parent database, and metadata.
update_data_sourceUpdate data sourcePATCHUpdates a data source's title, description, or archived status. Can move to different database via parent parameter.

Database, 3 operations

create_databaseCreate databasePOSTCreates a new Notion database as a child of a page. Define database title and property schema including property types and configurations. Returns the created database with its ID for subsequent operations.
get_databaseGet databaseGETRetrieves a Notion database's schema including all property definitions. Returns database title, description, property configurations (types, options), and parent info. Essential for understanding structure before querying or creating pages.
update_databaseUpdate databasePATCHUpdates a Notion database's database-level attributes: title, description, icon, cover, is_inline, in_trash, is_locked. Property schema is no longer edited here (apiVersion 2026-03-11); use update_data_source for schema changes.

Token, 3 operations

oauth_introspectOauth introspectPOSTIntrospects a token to check its validity, scope, and metadata. Use to validate tokens before operations.
oauth_revokeOauth revokePOSTRevokes an access token, invalidating it for future use. Use when users disconnect or for security.
oauth_tokenOauth tokenPOSTExchanges authorization code for access token. Used by public integrations for OAuth flow. Returns access_token and refresh_token.

User, 3 operations

get_meGet meGETReturns information about the bot associated with the current access token. Includes bot user ID, name, avatar, and owner details. Useful for identifying the integration in API responses.
get_userGet userGETRetrieves information about a Notion user. Returns user type (person or bot), name, and avatar URL. For people, includes email if integration has access. Essential for displaying user information in applications.
list_usersList usersGETLists all users in the Notion workspace including people and bots. Returns user IDs, names, types, and avatars. Supports pagination for workspaces with many members.

Property, 1 operation

get_page_propertyGet page propertyGETRetrieves a property item for a page. Essential when a property has more than 25 references (relations, people, rich_text). Returns paginated property values.

Template, 1 operation

list_data_source_templatesList data source templatesGETLists templates for a data source. Templates are pre-configured page structures for consistent content creation.

Use Notion from Claude Code, Cursor or Codex

Connect Notion in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Notion operations become tools the client can call, next to every other integration you connected.

Claude Code

claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"

Codex (~/.codex/config.toml)

[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"

Cursor, Claude Desktop and other JSON configs

{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Notion

Create your workspace
Sign up free. Nothing to install.
Connect Notion once
Add your Notion connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.

Notion integration FAQ

What can you do with the Notion integration?

LiveContext exposes 34 operations on Notion, covering page, block, file upload and comment. Common uses include renaming database, editing page content and auditing file uploads.