Notion
Connect Notion to your Appstrate agents, with the direct API integration or Notion's hosted MCP server.
Overview
Notion is a workspace for notes, docs and databases. Appstrate ships two Notion integrations, as separate packages.
| Integration | Source | How the agent reaches Notion |
|---|---|---|
@appstrate/notion (version 1.0.4) | api_call | Calls the Notion REST API directly. Needs an OAuth client registered by an administrator. |
@appstrate/notion-mcp (version 1.0.2) | Remote MCP | Uses Notion's hosted MCP server. The OAuth client is registered automatically at connect time. |
Notion (API): @appstrate/notion
| Property | Value |
|---|---|
| Type | oauth2 |
| Credential sent as | Authorization: Bearer <credential> |
| Token endpoint auth | client_secret_basic |
Notion does not use OAuth scopes: access is granted per page and database when the user authorizes. Authorized URI: https://api.notion.com/**.
Notion (MCP): @appstrate/notion-mcp
| Property | Value |
|---|---|
| Type | oauth2 |
| Credential sent as | Authorization: Bearer <credential> |
| Default scopes | none |
| Token endpoint auth | none |
The platform discovers Notion's authorization server and registers a public client on first connect (discovery, dynamic client registration and PKCE), so an administrator has nothing to configure. Authorized URI: https://mcp.notion.com/**.
Tools (14): notion-create-comment, notion-create-database, notion-create-pages, notion-create-view, notion-duplicate-page, notion-fetch, notion-get-comments, notion-get-teams, notion-get-users, notion-move-pages, notion-search, notion-update-data-source, notion-update-page, notion-update-view.
Connect Notion
For the MCP integration, activate it and members click Connect. For the API integration:
Create a public integration (type "Public") under "My integrations" (open).
Register the redirect URI APP_URL followed by /api/integrations/callback, as shown in the integration's setup panel.
In Appstrate, open the integration and register the OAuth client (client ID and client secret). See How integrations work.
Use it in an agent
Excerpt of the agent manifest:
{
"dependencies": {
"integrations": { "@appstrate/notion-mcp": "^1.0.0" }
},
"integrations_configuration": {
"@appstrate/notion-mcp": {
"tools": ["notion-search", "notion-fetch", "notion-create-pages"]
}
}
}Example prompt:
After each client call, find the client's page in Notion and add the action items
from the call notes under "Next steps".