> Godmode v0.20.0 documentation · Reviewed 2026-11-19
> Source: https://godmode.build/docs/provider-notion

# Notion

Keep product plans, research, and operating notes in pages your agent can update.

## Connect Notion

Keep a working [native login](/docs/credentials#keep-a-working-login), or save the keys below.

```sh
godmode setup notion
```

## Account access

The personal access token acts as its creator in one workspace, with the selected Notion API capability and that user's content permissions. The workspace can restrict who creates or uses PATs. An internal connection token is an alternative identity with capabilities and explicitly shared pages, independent of one user's membership.

## Add credentials

Save only the keys your product needs.

### Access token

Give your agent access to the workspace content used to run your product.

**[Visit Notion's token page](https://app.notion.com/developers/tokens)**

1. Select **New token** and name it.
2. Choose the workspace, **Notion API**, and an expiration.
3. Select **Create token**, then copy the token.

Save as `NOTION_API_KEY` in Godmode.

## Check access

- Use the Notion SDK or API to retrieve the token identity and an intended page or data source. Confirm the workspace and content access before creating or updating pages, databases or comments. The SDK must read NOTION_API_KEY explicitly.

## Restore access

- PATs expire within one year. Create a replacement through the Developer portal and save it with godmode set NOTION_API_KEY. An unauthorized response can also come from workspace PAT policy; missing content can reflect lost user access or a page not shared with an internal connection. Repair that access instead of repeatedly replacing tokens.

## Provider docs

- [Personal access tokens](https://developers.notion.com/guides/connections-and-tokens/personal-access-tokens)
- [Internal connections](https://developers.notion.com/guides/connections-and-tokens/internal-connections)

Source: Godmode v0.20.0 provider catalog · 2026-11-13.
