Notion

Notion Integration for HolmesGPT

Enabling this toolset allows HolmesGPT to fetch pages from Notion, making it useful when providing Notion-based runbooks.

Setup Instructions

1. Create a Webhook Integration

   • Go to the Notion Developer Portal.
   • Create a new integration with read content capabilities.

2. Grant Access to Pages

   • Open the desired Notion page.
   • Click the three dots in the top right.
   • Select Connections and add your integration.

3. Configure Authentication

   • Retrieve the Internal Integration Secret from Notion.
   • Create a Kubernetes secret in your cluster with this key.
   • Configure the NOTION_AUTH environment variable.

Configuration

Holmes CLIRobusta Helm Chart

First, set the environment variable:

export NOTION_AUTH="<your Notion integration secret>"

Then add the following to ~/.holmes/config.yaml. Create the file if it doesn't exist:

toolsets:
    notion:
        enabled: true

After making changes to your configuration, run:

holmes toolset refresh

holmes:
    additionalEnvVars:
        - name: NOTION_AUTH
          value: "<your Notion integration secret>"
    toolsets:
        notion:
            enabled: true
            config:
                additional_headers:
                    Authorization: Bearer {{ env.NOTION_AUTH }}

Update your Helm values and run a Helm upgrade:

helm upgrade robusta robusta/robusta --values=generated_values.yaml --set clusterName=<YOUR_CLUSTER_NAME>

Timeout Configuration

By default, the Notion toolset uses a 5-second timeout for webpage requests. If you need to increase the timeout for slower Notion API responses, you can set the INTERNET_TOOLSET_TIMEOUT_SECONDS environment variable:

Holmes CLIRobusta Helm Chart

export INTERNET_TOOLSET_TIMEOUT_SECONDS=30

holmes:
    additionalEnvVars:
        - name: INTERNET_TOOLSET_TIMEOUT_SECONDS
          value: "30"

Capabilities

The table below describes the specific capabilities provided by this toolset. HolmesGPT can decide to invoke any of these capabilities when answering questions or investigating issues.

Tool Name	Description
fetch_notion_webpage	Fetch a Notion webpage. Use this to fetch Notion runbooks if they are present before starting your investigation