Notion Omi Integration

Manage your Notion workspace through Omi chat - search pages, create content, query databases, and more.

Features

Search - Find pages and databases in your workspace
List Pages - View recently edited pages
Create Pages - Add new notes and content
Update Pages - Modify titles and archive pages
Append Content - Add text to existing pages
List Databases - See all your databases
Query Databases - View database entries

Setup

1. Create Notion Integration

Go to Notion Integrations
Click "New integration"
Fill in the basic information:
- Name: "Omi Integration"
- Associated workspace: Select your workspace
Under "Capabilities", ensure these are enabled:
- Read content
- Update content
- Insert content
Under "OAuth Domain & URIs":
- Redirect URIs: Add your callback URL (see below)
Click "Submit"
Copy the OAuth client ID and OAuth client secret

2. Deploy to Railway

Create a new project on Railway
Connect your GitHub repo or deploy from this folder
Add a Redis service to your project
Set environment variables:

NOTION_CLIENT_ID=your_client_id
NOTION_CLIENT_SECRET=your_client_secret
NOTION_REDIRECT_URI=https://your-app.up.railway.app/auth/notion/callback

Deploy! Railway will automatically:
- Install dependencies from requirements.txt
- Start the server using railway.toml config
- Provide PORT and REDIS_URL environment variables

3. Update Notion OAuth Redirect URI

After deployment, update your Notion integration with the actual Railway URL:

https://your-app.up.railway.app/auth/notion/callback

Omi App Configuration

When creating/updating the Omi app, use these URLs:

Field	Value
Setup URL	`https://your-app.up.railway.app/?uid={{uid}}`
Setup Completed URL	`https://your-app.up.railway.app/setup/notion?uid={{uid}}`
Chat Tools Manifest URL	`https://your-app.up.railway.app/.well-known/omi-tools.json`

API Endpoints

Chat Tools (POST)

Endpoint	Description
`/tools/search`	Search pages and databases
`/tools/list_pages`	List recent pages
`/tools/get_page`	Get page details and content
`/tools/create_page`	Create a new page
`/tools/update_page`	Update page properties
`/tools/append_content`	Add content to a page
`/tools/list_databases`	List all databases
`/tools/query_database`	Query database entries

OAuth & Setup (GET)

Endpoint	Description
`/`	Home page / setup UI
`/auth/notion?uid=<uid>`	Start OAuth flow
`/auth/notion/callback`	OAuth callback
`/setup/notion?uid=<uid>`	Check setup status
`/disconnect?uid=<uid>`	Disconnect account
`/health`	Health check
`/.well-known/omi-tools.json`	Chat tools manifest

Local Development

Copy .env.example to .env and fill in your credentials
Set NOTION_REDIRECT_URI=http://localhost:8080/auth/notion/callback
Add this to your Notion integration's redirect URIs
Install dependencies: pip install -r requirements.txt
Run: python main.py

Environment Variables

Variable	Description	Required
`NOTION_CLIENT_ID`	Notion OAuth Client ID	Yes
`NOTION_CLIENT_SECRET`	Notion OAuth Client Secret	Yes
`NOTION_REDIRECT_URI`	OAuth callback URL	Yes
`PORT`	Server port (default: 8080)	No
`REDIS_URL`	Redis connection URL	No (uses file storage if not set)

Example Chat Commands

"Search for meeting notes in Notion"
"Show my recent Notion pages"
"Create a new page called Project Ideas"
"Add 'remember to call John' to my todo page"
"Show my databases"
"What's in my Tasks database?"

Note on Page Permissions

When users connect their Notion workspace, they must grant access to specific pages. The integration can only access pages that users have explicitly shared with it during the OAuth flow.