Notion

Connect Pencel to Notion so your agents can search pages, read content, create new pages, and update databases. Notion is a popular choice for team wikis, project trackers, and meeting notes — and this integration lets your agents work with all of it.

Trust Level	Partner
Transport	Remote (OAuth)
Endpoint	https://mcp.notion.com/mcp
Activation	When relevant recommended

What Your Agent Can Do

• Search pages across your entire Notion workspace by title or content.
• Read page content including text, tables, lists, and embedded databases.
• Create new pages in any workspace or database you have access to.
• Update existing pages by appending or replacing content blocks.
• Query databases with filters and sorts to pull structured data.
• Create database entries to add rows to Notion databases.
• Update database properties to modify fields on existing entries.

Setup

Option A: OAuth (Recommended)

The easiest way to connect. Click, sign in, and you are done.

1. Open Settings > Connections.
2. Click Add Connection and select Notion from the catalog.
3. Click Connect — Pencel opens your browser to Notion's authorization page.
4. Select the pages and databases you want to grant access to.
5. Click Allow access. Return to Pencel.

INFO

With OAuth, you choose exactly which pages to share during the authorization step. You can update this later by reconnecting.

Option B: API Token

Best for personal use or when you want more control over access.

Step 1: Create an Internal Integration

1. Go to notion.so/my-integrations.
2. Click New integration.
3. Give it a name (e.g., "Pencel") and select your workspace.
4. Under Capabilities, enable the permissions your workflows need (read content, update content, insert content).
5. Click Submit. Copy the Internal Integration Secret (starts with ntn_).

Step 2: Share Pages with the Integration

Notion integrations can only access pages explicitly shared with them.

1. Open a Notion page or database you want your agent to access.
2. Click the ... menu in the top-right corner.
3. Select Connect to and choose your "Pencel" integration.
4. Repeat for every page or database your agent needs.

TIP

Share a top-level page to give the integration access to all its sub-pages. You do not need to share every page individually.

Step 3: Add the Connection in Pencel

1. Open Settings > Connections.
2. Click Add Connection and select Notion from the catalog.
3. Paste your Internal Integration Secret into the credential field.
4. Click Connect.

Example: Sync Meeting Notes to Workspace

Imagine your team keeps meeting notes in a Notion database and you want a local copy for agent reference.

Workflow setup:

1. Create a workflow called "Sync Meeting Notes."
2. Add a step with these instructions:

Search Notion for pages in the "Meeting Notes" database that were modified in the last 7 days. For each page, read the full content and save it as a markdown file in the workspace at /meeting-notes/[page-title].md. Include the date, attendees, and action items if present.

3. Schedule the workflow to run every Monday morning.

The agent pulls the latest meeting notes and saves them locally, so other agents and workflows can reference them without needing a live Notion connection.

Example: Update a Project Tracker

Query the "Q1 Projects" database in Notion. For each project marked "In Progress," check if there are any updates in the linked Slack channel from the last 3 days. Update the "Latest Update" property in Notion with a one-sentence summary of the most recent Slack discussion.

This combines Notion with the Slack integration to keep your project tracker fresh.

Troubleshooting

Problem	Solution
"Object not found" error	The integration does not have access to that page. Share the page with your integration in Notion, or reconnect via OAuth and grant access.
Search returns no results	Notion search only covers pages shared with the integration. Share the parent page to include sub-pages.
"Unauthorized" error	Your API token may be invalid. Regenerate it at notion.so/my-integrations, or reconnect via OAuth.
Cannot write to a database	Make sure "Update content" and "Insert content" capabilities are enabled on your integration.
OAuth permissions too narrow	Reconnect the integration and select additional pages during the authorization step.