Skip to content

Add Notion integration for read-only workspace access #182

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
vltbaudbot wants to merge 1 commit into
base: main
Choose a base branch
from
+792 −3
Open

Add Notion integration for read-only workspace access #182

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 7 additions & 0 deletions .env.schema
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -182,6 +182,13 @@ SLACK_BROKER_DEDUPE_TTL_MS=1200000
# @docs(https://linear.app/settings/api)
LINEAR_API_KEY=

# ── Notion (optional) ────────────────────────────────────────────────────────

# Notion integration secret (internal integration token)
# @type=string
# @docs(https://www.notion.so/my-integrations)
NOTION_API_KEY=

# ── Tool Guard ───────────────────────────────────────────────────────────────

# Unix username of the agent
Expand Down
17 changes: 17 additions & 0 deletions CONFIGURATION.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -84,6 +84,23 @@ The `linear` extension provides a tool for interacting with the Linear issue tra
|----------|-------------|---------------|
| `LINEAR_API_KEY` | Linear API key (personal or OAuth token) | Go to [Linear Settings → API](https://linear.app/settings/api), create a **Personal API key**. For workspace-wide access, create an OAuth application instead. The key needs read/write access to issues and comments. |

### Notion Integration

The `notion` extension provides a read-only tool for accessing your Notion workspace. The agent can search for pages and databases, retrieve full page content (including nested blocks), query database entries, and inspect database schemas.

| Variable | Description | How to get it |
|----------|-------------|---------------|
| `NOTION_API_KEY` | Notion integration secret (internal integration token) | Go to [Notion → My integrations](https://www.notion.so/my-integrations), create a new **Internal Integration**. Copy the **Internal Integration Token** (starts with `secret_`). After creating the integration, share the pages/databases you want the agent to access by clicking **"•••"** → **Add connections** → select your integration. The integration can only read content explicitly shared with it. |

**Capabilities:**
- `search` — Find pages and databases by text query or type filter
- `get` — Read full page content with all blocks (paragraphs, headings, lists, code, callouts, etc.)
- `list` — Query database entries with filters and sorting
- `database` — Inspect database schema and property types

**Permissions:**
The integration token only provides read access to pages/databases explicitly shared with the integration. It cannot create, update, or delete content.

### Slack Channels

| Variable | Description | How to get it |
Expand Down
Loading
Loading