Reference

Notion Integration

Some knowledge belongs in Notion — PRDs, long-form docs, cross-team pages. Knowit can route agents there instead of duplicating it.

Connecting Notion

Terminal

$ knowit source connect notion

This registers Notion as an external source. You can also connect it during npx knowit install with --source notion, or from an agent via the connect_source MCP tool. If your Notion MCP server runs under a non-default name, pass --mcp-server-name.

How routing works

When an agent wants to read or write an artifact and the right home is ambiguous, it calls resolve_source_action with the action (read or write) and artifact type (knowledge, prd, plan, doc, decision, or note). Knowit decides whether to handle it directly or return guidance pointing the agent at the downstream provider's MCP tools.

The division of labor stays clean:

Knowit holds operational engineering memory — rules, patterns, decisions agents need mid-task.
Notion holds canonical long-form docs, with Knowit routing agents to them when needed.

Custom MCP sources

Notion is a first-class provider, but any MCP server can be a source. Register one with explicit tool mappings:

Terminal

$ knowit source add-mcp my-kb "npx" --args "-y,my-kb-mcp" \
  --store-tool store_note --search-tool search_notes

Agents can do the same at runtime through the register_mcp_source MCP tool. See MCP Tools.