> ## Documentation Index
> Fetch the complete documentation index at: https://docs.honeycomb.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect Notion to Canvas

> Connect your Notion account so the Canvas Agent can read and update your runbooks and documentation during an investigation.

export const HnyIcon = ({alias, path, size = 16, iconColor}) => {
  const iconMap = {
    "home": "house.svg",
    "marker": "caretFilledDown.svg",
    "show-marker-options": "chatTextLeft.svg",
    "download": "arrowLineDown.svg",
    "trace-waterfall": "trace.svg",
    "show-query-details": "listDashes.svg",
    "table": "table.svg",
    "log-lines": "logLines.svg",
    "chart": "chartLine.svg",
    "show-settings": "gear.svg",
    "add": "plus.svg",
    "remove": "delete.svg",
    "persist": "caretDown.svg",
    "close": "close.svg",
    "copy": "copy.svg",
    "zoom-in": "magnifyingGlassPlus.svg",
    "zoom-out": "magnifyingGlassMinus.svg",
    "color-assignment": "drop.svg",
    "drag": "dots-six-vertical.svg",
    "drawer": "drawer.svg",
    "show-actions": "dotsThree.svg",
    "edit": "pencil.svg",
    "delete": "trash.svg",
    "move": "arrowsOutCardinal.svg",
    "show-legend": "circleInfo.svg",
    "usage-ok": "usageGood.svg",
    "usage-warning": "usageWarning.svg",
    "usage-danger": "usageDanger.svg",
    "open-query-builder": "query.svg",
    "home-menu": "house.svg",
    "query-menu": "query.svg",
    "boards-menu": "board.svg",
    "triggers-menu": "bell.svg",
    "slos-menu": "handshake.svg",
    "service-map-menu": "serviceMap.svg",
    "history-menu": "clockCounterClockwise.svg",
    "manage-data-menu": "cube.svg",
    "usage-menu": "usageGood.svg",
    "canvas-menu": "sparkle.svg",
    "anomalies-menu": "anomalies.svg",
    "show-details": "dotsThreeVertical.svg",
    "resize-handle": "board-panel-resize-handle.png",
    "standard-dataset": "cube.svg",
    "trace-dataset": "cubeChat.svg",
    "all-datasets": "linkedSquares.svg",
    "share": "arrowBentRight.svg",
    "run-in-query-builder": "arrowSquareUpRight.svg",
    "link": "link.svg",
    "text": "text.svg",
    "receive": "arrowLineDown.svg",
    "process": "lightning.svg",
    "sample": "drop.svg",
    "send": "arrowLineUp.svg",
    "submit": "arrowUp.svg",
    "canvas-menu": "sparkle.svg",
    "canvas": "sparkle.svg",
    "chat-about-this-page": "sparkle.svg",
    "private": "lockKey.svg",
    "shared": "people.svg",
    "expand": "caretDown.svg",
    "previous": "caretLeft.svg",
    "next": "caretRight.svg",
    "expand-chat": "caretLeft.svg",
    "minimize-chat": "caretRight.svg",
    "open-in-canvas": "arrowSquareUpRight.svg",
    "send-test": "EnvelopeSimple.svg",
    "ai-ecosystem": "robot.svg"
  };
  const iconBasePath = "/_assets/icons/";
  const iconPath = path || (alias ? `${iconBasePath}${iconMap[alias]}` : undefined);
  return <span className="hny-icon" style={{
    display: "inline-block",
    width: `${size}px`,
    height: `${size}px`,
    maskImage: `url(${iconPath})`,
    maskSize: "contain",
    maskRepeat: "no-repeat",
    maskPosition: "center",
    WebkitMaskImage: `url(${iconPath})`,
    WebkitMaskSize: "contain",
    WebkitMaskRepeat: "no-repeat",
    WebkitMaskPosition: "center",
    backgroundColor: iconColor || "var(--hny-icon-color)",
    verticalAlign: "middle"
  }} />;
};

Connect your Notion account to let the Canvas Agent use your runbooks and documentation during an investigation.

<Tip>
  Connectors work per user and per Honeycomb Team.
  You connect your own account, and the Canvas Agent uses the connected service as your account.
  Connecting a connector does not connect it for anyone else on your Honeycomb Team.
  If you belong to more than one Honeycomb Team, connect your account in each Team.
  Your [tool permissions](/investigate/canvas/connectors/#managing-tool-permissions) also apply only to you, in one Honeycomb Team.
  There are no Team-level connector controls yet.

  Connectors work through your account, so an [automatic investigation](/investigate/canvas/auto-investigate/) has no connector access at all.
</Tip>

## What the Canvas Agent can do

* Read your runbooks and documentation.
* Create or update pages.

<Note>
  Honeycomb reviews each tool in a connector and gives it a default permission.
  Until you set your own tool permissions, these defaults apply:

  * The Canvas Agent runs reviewed read-only tools without asking.
  * For reviewed write tools and destructive tools, the Canvas Agent asks you to approve each call.
  * The Canvas Agent does not run deprecated tools.

  The Canvas Agent runs a tool only when your investigation needs it.
  To change the defaults, visit [Managing tool permissions](/investigate/canvas/connectors/#managing-tool-permissions).
</Note>

## Before you connect

On the Notion Enterprise plan, workspace admins can control which MCP clients connect to the workspace.
If your admins restrict MCP clients, ask them to allow Honeycomb before you connect.

## Connecting Notion

1. Navigate to <HnyIcon alias="canvas" /> **Canvas** > **Connectors**.
2. Find **Notion** in the connector list.
3. Select **Connect**.
4. Authorize Honeycomb from the Notion authorization page.

Notion shows a **Connected** badge once the connection succeeds.

## Turning Notion on or off

1. In a Canvas chat, select the <HnyIcon alias="add" /> plus (`+`) button.
2. Choose **Connectors**.
3. Use the toggle beside **Notion**.

## Disconnecting Notion

1. Navigate to <HnyIcon alias="canvas" /> **Canvas** > **Connectors**.
2. Find **Notion** and select **Manage**.
3. Select **Disconnect**.

To learn more, visit [Canvas Connectors](/investigate/canvas/connectors/).