Connect your Notion account to Goodweek to read, create, and update pages and databases directly from your AI workspace.
ℹ️ Governance note
Goodweek will never exceed the access levels granted to the user within Notion, guaranteeing alignment with your organization's governance policies. Outcomes and available features may vary depending on each user's specific permissions and authenticated access.
📋 Prerequisites
Before any user can see and connect the Notion integration, your organization admin must first enable it from the Goodweek Admin Panel under the Integrations tab.
Admin Setup
The Notion integration uses OAuth 2.0 and does not require any admin-level approval before users can connect.
⚠️ Notion Enterprise workspaces
If your organization uses Notion Enterprise and has restricted external integrations, a workspace admin may need to enable Composio under Settings & members → Connections before users can connect.
User Connection
In Goodweek, go to Integrations.
Find Notion and click Connect.
You will be redirected to Notion, where you will be asked to sign in and authorize access.
Select the pages and databases you want to grant Goodweek access to and click Allow access to return to Goodweek.
💡 Important: Notion uses page-level access control
Notion requires you to explicitly select which pages and databases Goodweek can access during the connection step. Goodweek will only be able to see and interact with the pages you select. To grant access to additional pages later, go to Notion → Settings & members → Connections → Composio → Edit access.
Important Notes
Each user must connect their own account individually.
Goodweek can only access the Notion pages and databases you explicitly granted access to during the connection flow.
You can revoke Goodweek's access at any time from Notion → Settings & members → Connections → Composio → Disconnect.
Available Tools
Tool | Description | Type |
Create Notion Page | Creates a new page in a Notion workspace under a specified parent page or database, with optional markdown content. | Write |
Update Page | Updates page properties, icon, cover, or archive status. | Write |
Get Page Markdown | Retrieves a Notion page's full content rendered as Markdown in a single call. | Read |
Retrieve Page | Retrieves a page's properties and metadata by its ID. | Read |
Duplicate Page | Duplicates a Notion page including all its content, properties, and nested blocks under a specified parent. | Read |
Move Page | Moves a Notion page to a new parent page or database. | Read |
Archive Notion Page | Archives (moves to trash) or unarchives (restores) a specified Notion page. | Write |
Add Multiple Content Blocks | Bulk-adds content blocks to a Notion page, with automatic text splitting for content over 2000 characters. | Write |
Append Text Blocks | Appends text blocks (paragraphs, headings, lists) to a Notion page. | Read |
Append Task Blocks | Appends task blocks (to-do checkboxes, toggles, callouts) to a Notion page. | Read |
Append Code Blocks | Appends code, quote, or equation blocks to a Notion page. | Read |
Append Media Blocks | Appends media blocks (images, videos, audio, files, embeds) to a Notion page. | Read |
Append Layout Blocks | Appends layout blocks (dividers, table of contents, columns) to a Notion page. | Read |
Append Table Blocks | Appends structured table blocks to a Notion page. | Read |
Update Block | Updates an existing Notion block's text content (max 2000 characters). | Write |
Delete Block | Archives a Notion block, page, or database (equivalent to moving to trash). | ⚠️ Destructive |
Fetch Block Children | Retrieves a paginated list of direct child blocks for a given Notion page or block. | Read |
Fetch All Block Contents | Retrieves all child blocks for a Notion block, with automatic pagination to return complete results. | Read |
Create Notion Database | Creates a new Notion database as a subpage under a specified parent page with a defined properties schema. | Write |
Fetch Database | Retrieves a Notion database's structural metadata including properties and title. | Read |
Query Database | Queries a Notion database to retrieve pages (rows) with optional filtering and sorting. | Read |
Query Database with Filter | Queries a Notion database with server-side filtering, sorting, and pagination for more precise results. | Read |
Insert Row into Database | Creates a new page (row) in a specified Notion database with defined property values. | Write |
Insert Row from Natural Language | Creates a new row in a Notion database from a natural language description, automatically mapping values to the correct fields. | Write |
Update Database Row | Updates a specific row (page) within a Notion database by its ID. | Write |
Update Database Schema | Updates an existing Notion database's schema including title, description, and properties. | Write |
Upsert Database Rows | Queries for existing rows and creates or updates them — ideal for adding data without creating duplicates. | Read |
Search Notion Pages and Databases | Searches Notion pages and databases by title using specific search terms. | Read |
Fetch Notion Data | Fetches Notion items (pages and databases) from the workspace with a query or filter. | Read |
Create Comment | Adds a comment to a Notion page or replies to an existing discussion thread. | Write |
Fetch Comments | Fetches unresolved comments for a specified Notion block or page. | Read |
List Users | Retrieves a paginated list of users from the Notion workspace. | Read |
Get About User | Retrieves detailed information about a specific Notion user including name, avatar, and email. | Read |
Replace Page Content | Safely replaces a page's child blocks by optionally backing up current content, then replacing with new blocks. | Read |
Use Cases
Create and populate pages and databases from conversations. Ask Goodweek to create a new Notion page with structured content, or add rows to an existing database — for example, logging meeting notes, creating project briefs, or adding tasks — without leaving your workspace.
Query and retrieve Notion data on demand. Search across pages and databases, filter records by property, and pull specific content into your Goodweek conversation to reference or build on without switching to Notion.
Update records without duplicating them. Add new entries to a Notion database from Goodweek while checking for existing matches first, so your data stays clean and consistent regardless of how many times you add similar records.
Enrich pages with structured content. Append text, tables, checklists, code blocks, and media to any Notion page from Goodweek — useful for building structured reports, documentation, or meeting summaries directly in your knowledge base.
Troubleshooting
Goodweek cannot find a page or database I created in Notion
Notion requires you to explicitly grant access to each page during the connection flow. Go to Notion → Settings & members → Connections → Composio → Edit access and add the missing page.
Connection fails with an error during the Notion authorization step
If your organization uses Notion Enterprise, your workspace admin may have restricted external integrations. Ask your Notion admin to check Settings & members → Connections and enable Composio.
Integration not visible in Goodweek
Make sure your organization admin has enabled the Notion integration from the Goodweek Admin Panel under the Integrations tab.