Skip to main content

​
Pages and Databases

The Notion integration connects Wolffish to your Notion workspace for searching, reading, creating, and querying pages and databases. It uses a Notion internal integration token for authentication.

​
Setup

1

Create an Integration

Go to notion.so/my-integrations and click “New integration”. Give it a name (e.g., “Wolffish”) and select the workspace.
2

Copy the Token

After creation, copy the Internal Integration Token (starts with ntn_ or secret_).
3

Configure in Wolffish

Open Settings > Integrations > Notion and paste the token.
4

Share Pages with the Integration

In Notion, open each page or database you want Wolffish to access. Click the ”…” menu > “Connections” > find your integration and connect it.
The integration can only access pages and databases that have been explicitly shared with it. If Wolffish can’t find a page, check that the page’s Connections include your integration.

​
Available Tools

​
Search and Read

ToolDescription
notion_searchSearch pages and databases by title or content
notion_read_pageRead page properties (title, dates, tags, etc.)
notion_read_blocksRead the block content of a page (paragraphs, lists, code, etc.)

​
Create and Update

ToolDescription
notion_create_pageCreate a new page in a parent page or database
notion_update_pageUpdate page properties
notion_append_blocksAppend new blocks to the end of a page

​
Databases

ToolDescription
notion_create_databaseCreate a new database with defined properties
notion_query_databaseQuery a database with filters and sorts
notion_add_commentAdd a comment to a page or discussion

​
Database Querying

The notion_query_database tool supports Notion’s filter and sort format: 
{
  "database_id": "abc123...",
  "filter": {
    "property": "Status",
    "status": {
      "equals": "In Progress"
    }
  },
  "sorts": [
    {
      "property": "Priority",
      "direction": "descending"
    }
  ]
}
Compound filters are supported: 
{
  "filter": {
    "and": [
      {
        "property": "Status",
        "status": { "equals": "In Progress" }
      },
      {
        "property": "Assignee",
        "people": { "contains": "user-id-here" }
      }
    ]
  }
}
You don’t need to write raw filter JSON yourself. Just describe what you want — “show me tasks assigned to me that are in progress” — and the LLM constructs the appropriate filter.

​
Supported Block Types

When creating or appending content, Wolffish supports these Notion block types:
Block TypeDescription
paragraphStandard text paragraph
heading_1Large heading
heading_2Medium heading
heading_3Small heading
bulleted_list_itemBulleted list item
numbered_list_itemNumbered list item
toggleCollapsible toggle block
codeCode block with language syntax
quoteBlock quote
calloutCallout with icon
dividerHorizontal divider
tableTable block
bookmarkBookmarked URL

​
Triggers

The Notion capability activates when your message matches any of these patterns: 
notion, workspace, wiki, knowledge base,
database, page, kanban, board, backlog,
sprint, project tracker, notes

​
Example Workflows

You: "Search my Notion for the API spec"
Wolffish: Calls notion_search with "API spec" and returns matching pages
with titles and parent locations.

You: "Add a new task to my project database: implement login flow, priority high"
Wolffish: Calls notion_create_page with the database as parent and sets
the Title, Status, and Priority properties.

You: "What tasks are in progress?"
Wolffish: Calls notion_query_database with a Status = "In Progress" filter
and returns matching entries with their properties.

You: "Add a section about error handling to my API documentation page"
Wolffish: Searches for the page, then calls notion_append_blocks with
heading and paragraph blocks containing the new content.

​
Configuration Reference

The Notion token is stored as a Variable in Settings: 
{
  "variables": {
    "NOTION_TOKEN": "ntn_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
  }
}
Alternatively, in config.json: 
{
  "integrations": {
    "notion": {
      "token": "ntn_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
    }
  }
}
Notion’s API has rate limits (3 requests per second for integrations). Wolffish handles retries with exponential backoff automatically through the motor module. If you’re doing bulk operations, responses may be slightly slower than usual.
Never share your Notion integration token. Anyone with the token can read and modify all pages the integration has access to. If you suspect a token leak, rotate it immediately at notion.so/my-integrations.