Skip to content
Nappai Documentation

Notion MCP

The Notion MCP component lets you interact with your Notion workspace from the Nappai dashboard. By providing a Notion API token, the component automatically discovers all available Notion tools (like reading a database, creating a page, etc.) and lets you choose which one to use in your workflow.

How it Works

When you add the Notion MCP component, you supply your Notion API Token (the integration token you get from Notion). The component then talks to the Notion API on your behalf. It scans your workspace to find all the tools that can be used (for example, “Read Database”, “Create Page”, “Update Page”, etc.) and lists them in the Tool dropdown. Once you pick a tool, the component sends the appropriate request to Notion and returns the result.

The component does not perform any heavy processing locally; all work is done by the Notion API. This keeps your data secure and ensures you’re always using the latest Notion features.

Inputs

  • Notion API Token: Paste the integration token you created in Notion. This token gives the component permission to read and write data in your workspace.

    • Visible in: All operations (the component only has one operation, so it’s always visible)

  • Tool: Choose the specific Notion action you want to perform (e.g., “Read Database”, “Create Page”, etc.). The list is automatically populated based on what your token can access.

    • Visible in: All operations

Outputs

The component returns the raw response from the Notion API for the selected tool. This can be a list of database entries, the details of a newly created page, or any other data that the chosen tool provides. You can then feed this output into other components in your workflow.

Usage Example

  1. Add the Notion MCP component to your flow.
  2. Enter your Notion API Token in the “Notion API Token” field.
  3. Select “Read Database” from the “Tool” dropdown.
  4. Configure any additional parameters that the tool requires (e.g., database ID).
  5. Run the flow. The component will return the list of pages in that database, which you can then pass to a “Filter” component or display in a dashboard.
  • Notion Query – A simpler component for running custom Notion queries.
  • Notion Update – Lets you modify existing pages or database entries.
  • Notion Create – Creates new pages or database entries in Notion.

Tips and Best Practices

  • Keep your API token secret: Store it in Nappai’s secure secrets manager instead of hard‑coding it in a flow.
  • Use the “Mapping Mode” (if available) to pull the database ID from a previous component instead of typing it manually.
  • Check the API limits: Notion imposes rate limits; if you’re running many queries, add a delay or batch them.
  • Validate responses: Add a “JSON Validator” component after Notion MCP to ensure the data structure matches what you expect.

Security Considerations

  • The API token grants full access to the parts of your Notion workspace that the token can reach. Treat it like a password.
  • Never expose the token in public flows or share the flow file without removing the token.
  • Use Nappai’s built‑in encryption for storing secrets to keep the token safe at rest.