Import
How to import Notion into Cozy
There are two ways to bring Notion into Cozy. Connect the Notion connector, which reads the pages you share, including nested block text, and stores them as sources. Or export Markdown and CSV from Notion and upload the files. The connector suits ongoing sync. The export suits a one-time snapshot or pages you cannot share.
Cozy is a private wiki and file space for you and your AI agents. Imported Notion content lands as evidence your agent can cite, and you decide what becomes a curated wiki page. This guide covers both routes, what Notion's export loses, and how to check the result.
Choose a route
| Notion connector | Markdown and CSV export | |
|---|---|---|
| Best for | Pages you keep editing in Notion | One-time move or archive |
| What comes in | Shared pages and nested block text | Whatever Notion writes to the zip |
| Setup | Connect Notion, share pages | Export, unzip, upload or push |
| Updates | Re-reads the shared pages | Re-export and re-push |
Pick the connector if Notion stays your day-to-day editor. Pick the export if you are leaving Notion, or if some pages should never be connected.
Route 1: the Notion connector
Cozy lists Notion among its connectors, alongside Gmail, Google Drive, Slack and others. The Notion connector works on shared pages: you choose what to share, and Cozy reads those pages and their nested block text.
- Open your workspace in Cozy and add the Notion connector.
- Authorize it and share only the Notion pages you want Cozy to see.
- Let the first sync finish, then look in
sources/.
Everything the connector brings in goes to sources/. That folder holds evidence with stable IDs, URLs and timestamps, and Cozy treats it as untrusted data. Your agent reads it, then writes curated pages into wiki/ that link back to it. Those links into sources/ become citations, which is how Health later tells you a page is stale when its source changes. See source citations.
Connector credentials stay out of agent reach. Agents cannot see connector credentials, so a connected agent cannot read your Notion authorization.
Route 2: Markdown and CSV export
In Notion, export your content as Markdown and CSV. Notion documents several behaviors in its export help page:
- Pages without databases export as Markdown.
- Full-page databases export as CSV, with a Markdown file for each subpage.
- Callouts export as HTML.
- Only the current or default view of a database exports, and form views cannot be exported.
- Whole-workspace exports can take up to 30 hours, and the download link expires after 7 days.
- An export cannot be uploaded back to Notion to recreate a workspace.
Plan around those limits. Export in smaller batches if the full workspace is slow, download the zip promptly, and check that each database you care about came out as CSV. If a database relied on views or relations, record what you need before you export, because the export is a one-way snapshot.
Upload the files
Cozy accepts Markdown, text, JSON and CSV. In the web app you can upload up to 25 files per selection, at up to 1 MB each. Unzip the export first and select the .md and .csv files.
Push many files with the ingest API
For larger exports, use the ingest API. Send documents as JSON, up to 25 per request and 1.5 MB each:
curl -X POST "https://cozy.cloud/api/wiki/workspaces/$COZY_WORKSPACE/ingest" \
-H "Authorization: Bearer $COZY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"documents":[{"id":"notion/project-plan","content":"# Project plan\n..."}]}'
Choose a stable id for each page, such as the Notion page path. Pushing the same id again updates the same source instead of creating a duplicate. Sources you delete are never re-imported, so a later push will not bring back something you removed on purpose. Documents go to the built-in Inbox by default.
Notion's file names often end in a long hash. Strip it when you build the id, so a re-export maps to the same source.
Turn sources into wiki pages
Imported pages are raw material. Ask your own agent, through the workspace MCP server, to read a source with cozy_read, write a curated page with cozy_write, and link back to the source. A database exported as CSV works well here: the agent can turn rows into pages with a type, tags and typed relations. Cozy runs no model itself, so you bring the agent. Curated pages can be up to 90,000 bytes, while imported sources can be up to 1,500,000 bytes.
If you have not connected an agent yet, see Claude Code, Codex or Claude. Create a credential with the narrowest scope you need. A source-write scope is enough for pushing documents, and a folder-prefix grant limits where an agent can write.
Check the result with Health
After the import, run cozy_health. It reports broken links, duplicate titles and aliases, orphans, unsourced pages, pages with a missing type or description, oversized pages, and sources nothing cites. Each page starts at 1.0 and loses weight per issue, and the score is the average times 100. The next list gives fixes in priority order. Notion exports tend to produce broken links, because Notion's internal links do not always point at the file names in the export. Expect to repair some. See wiki health.
Where Notion is the better tool
Notion is stronger for live databases with views, team project tracking and in-product editing with collaborators. Cozy stores plain files and does not recreate Notion databases. If you rely on those features, keep Notion for them and use the connector so your agents can read the shared pages. For a fuller comparison, read Cozy vs Notion.
FAQ
The questions below cover the common edge cases. For other tools, see the guides for Obsidian and Markdown.
Frequently asked questions
Does the Notion connector import my whole workspace?
It works on shared pages, so you decide what Cozy can read. Pages you do not share are not imported. Connector content is stored under sources/ as evidence.
Will my Notion databases survive the Markdown export?
Full-page databases export as CSV, with a Markdown file per subpage, and only the current or default view exports. Upload the CSV to Cozy, then ask your agent to turn rows into pages with types and relations.
Can I re-import after I edit pages in Notion?
Yes. With the connector, Cozy re-reads the shared pages. With exports, push again using the same stable id and Cozy updates the same source. Sources you deleted are never re-imported.
How large can an uploaded file be?
Browser upload takes up to 1 MB per file and 25 files per selection. The ingest API takes up to 25 documents per request at 1.5 MB each. See the FAQ for more.
Does Cozy convert my Notion pages into wiki pages automatically?
No. Imports arrive as sources. Cozy runs no model itself, so your own agent reads them and writes curated wiki pages that cite the sources.
Give your agents a memory worth keeping
Cozy gives every account a private wiki that Claude, Codex, ChatGPT and other MCP clients can read and maintain.
Start your wiki