Skip to content

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

First, set the environment variable: 

export NOTION_AUTH="<your Notion integration secret>"

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

toolsets:
    notion:
        enabled: true


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>

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

Need Custom Integration?

By adding custom toolsets, users can extend HolmesGPT's investigation capabilities to address unique use cases, specific infrastructure setups, or organization-specific requirements. For example, custom toolsets might include specialized log analysis patterns or integration with external monitoring systems.

Can't find the toolset you need? Create a custom toolset or request a new integration.