@reneza/ats-adapter-notion

ats-adapter-notion is a Notion adapter for the Agentic Task System (ATS) — it turns your Notion pages into agent memory an LLM can retrieve, with hybrid RRF search and an MCP server for Claude Code, Claude Desktop, and Cursor. It is the Notion MCP server side of ATS: point it at a database and every page becomes retrievable context for your agent.

An Agentic Task System storage adapter over Notion. Point ATS at a database and every page becomes agent-queryable alongside your other ATS sources, fused by RRF and exposed over MCP. Adapter, not migration — the data stays in Notion.

Under the hood it gives Claude Code Notion access as agent memory: RAG / retrieval over your Notion pages, combined with hybrid search (keyword plus dense vectors) so an agent can pull the right page from your Notion workspace as supporting context for the task it's working on, without you copy-pasting it into the prompt.

Mapping

| ATS | Notion | | -------------- | ---------------------------------------------------------------------- | | Project | a database / data source (id = the database id) | | Task | a page (id = the page UUID) | | title | the page's title-type property (plain text) | | content | the page body rendered to markdown (paragraph, headings, lists, to_do, code, quote) | | tags | a multi_select property named Tags/tags, else [] | | dueDate | a date property named Due/Deadline, if present | | modifiedTime | the page's last_edited_time |

listTasksInProject skips the per-page body fetch for speed and falls back to a rich_text property for content; getTask fetches block children for the full markdown body. searchByQuery (Notion /v1/search) and bulkFetch are implemented; embeddings is intentionally omitted, so Core handles dense retrieval.

Auth — share the database, cap the blast radius

Auth is a Notion internal integration token. Create one at https://www.notion.so/my-integrations and copy its Internal Integration Secret (starts with ntn_ or secret_). Then SHARE only the specific database(s) and pages you want ATS to see with the integration — open the database, use the ... menu > Connections, and add your integration.

This per-page/per-database sharing IS the least-privilege boundary in Notion: the token can only ever read what you explicitly connect it to, so a leaked token is contained to those databases rather than your whole workspace. It is the same principle as sharing a single folder with a dedicated, read-only collaborator rather than handing over the account.

Configure via env:

export ATS_NOTION_TOKEN=ntn_...
export ATS_NOTION_DATABASES=dbid1,dbid2      # optional allow-list; omit to use every database shared with the integration

or ~/.config/ats/notion.json (chmod 600):

{
  "token": "ntn_...",
  "databases": ["dbid"],
  "defaultDatabase": "dbid"
}

Use

ats config use @reneza/ats-adapter-notion     # or: ATS_ADAPTER=./packages/adapter-notion
ats doctor                                     # checks token, database access, capabilities
ats find "supplier reconciliation"             # retrieval across your Notion pages
ats adapter test ./packages/adapter-notion     # conformance kit (add --write to exercise create/update)

Verify

node --test     # offline unit tests (mocked Notion API)

FAQ

Is this a Notion MCP server? Yes. Through ATS it exposes your Notion databases over MCP, so Claude Code, Claude Desktop, and Cursor can query your Notion pages as agent memory.

How do I give Claude access to my Notion pages? Create a Notion internal integration, share only the databases and pages you want read with that integration, point ATS at the token, and those pages become RAG / retrieval over Notion inside any MCP client.

Does it work without a vector database? Yes. Notion search and keyword retrieval run out of the box; ATS Core adds hybrid search (dense vectors fused with keyword via RRF) when you want stronger retrieval — the adapter omits embeddings so Core owns that layer.

Part of the Agentic Task System

This Notion adapter is one backend in a family that all share the same retrieval, RRF fusion, and MCP surface — mix Notion agent memory with any of the siblings:

• @reneza/ats-adapter-ticktick
• @reneza/ats-adapter-obsidian
• @reneza/ats-adapter-github
• @reneza/ats-adapter-airtable
• @reneza/ats-adapter-google
• @reneza/ats-adapter-okf
• @reneza/ats-adapter-taskmaster
• @reneza/ats-adapter-beads

See the main repo: agentic-task-system.