---
title: "Notion integration for LuumenAI"
url: "https://www.luumen.ai/integrations/notion/"
entity: SoftwareIntegration
category: "Knowledge & documentation"
audience: "SRE, DevOps, platform engineering, IT operations"
---

# Notion integration for LuumenAI

Runbooks in Notion, followed and turned into skills.

## What LuumenAI can do with Notion

LuumenAI connects to Notion with an API token and exposes 54 tools (26 read-only · 22 write · 6 destructive). Reads answer immediately; writes are shown as a plan and require approval by default, configurable per tool by an administrator.

## Key facts

- Authentication: API token
- Tools available: 54 tools (26 read-only · 22 write · 6 destructive)
- Plan: available on all plans
- Category: Knowledge & documentation

## About Notion with LuumenAI

Turn what your team wrote down in Notion into something that runs. LuumenAI searches SOPs and runbooks, follows them step by step, and can package a page into a shared skill — with updates written back only after review.

## Example tools

Read-only (26 in total):

- `NOTION_CREATE_VIEW_QUERY` — Create a Notion view query and return the first page of page references.
- `NOTION_FETCH_ALL_BLOCK_CONTENTS` — Fetch all child blocks for a given Notion block.
- `NOTION_FETCH_BLOCK_CONTENTS` — Retrieves a paginated list of direct, first-level child block objects along with contents for a given parent Notion block or page ID; use block IDs from the response for subsequent calls to access…
- `NOTION_FETCH_BLOCK_METADATA` — Fetches metadata for a Notion block (including pages, which are special blocks) using its UUID.
- `NOTION_FETCH_COMMENTS` — Fetches unresolved comments for a specified Notion block or page ID.
- `NOTION_FETCH_DATA` — Fetches Notion items (pages and/or databases) from the Notion workspace, use this to get minimal data about the items in the workspace with a query or list all items in the workspace with minimal data
- `NOTION_FETCH_DATABASE` — Fetches a Notion database's structural metadata (properties, title, etc.) via its `database_id`, not the data entries; `database_id` must reference an existing database.
- `NOTION_FETCH_ROW` — Retrieves a Notion database row's properties and metadata; use fetch_block_contents for page content blocks.

Write and destructive (28 in total, approval required by default):

- `NOTION_ADD_MULTIPLE_PAGE_CONTENT` — Bulk-add content blocks to Notion.
- `NOTION_APPEND_CODE_BLOCKS` — Append code and technical blocks (code, quote, equation) to a Notion page.
- `NOTION_APPEND_LAYOUT_BLOCKS` — Append layout blocks (divider, TOC, breadcrumb, columns) to a Notion page.
- `NOTION_APPEND_MEDIA_BLOCKS` — Append media blocks (image, video, audio, file, pdf, embed, bookmark) to a Notion page.
- `NOTION_APPEND_TABLE_BLOCKS` — Append table blocks to a Notion page.
- `NOTION_APPEND_TASK_BLOCKS` — Append task blocks (to-do, toggle, callout) to a Notion page or block.
- `NOTION_APPEND_TEXT_BLOCKS` — Append text blocks (paragraphs, headings, lists) to a Notion page.
- `NOTION_ARCHIVE_NOTION_PAGE` — Archives (moves to trash) or unarchives (restores from trash) a specified Notion page.

## Frequently asked questions

### How does LuumenAI connect to Notion?

Authorize once with API token. Luumen lists the scopes each action needs before you approve the connection, and credentials never appear in the chat.

### Can LuumenAI change things in Notion on its own?

Read actions answer immediately. Anything that writes is shown as a plan and requires approval by default, including the 6 actions classified as destructive. Administrators configure that per tool.

### Is there an audit trail?

Every call to Notion — read or write, approved or declined — is recorded with the actor, the input, and the result.

Full page: https://www.luumen.ai/integrations/notion/