A research wiki your agent keeps for writers and journalists

Updated · By the Cozy team

A research wiki for writers and journalists is a set of linked Markdown pages built from your sources: interviews, documents, articles and notes. Cozy hosts that wiki privately, and your own AI agent maintains it over MCP. Each claim links to the source it came from, and disagreements between sources are marked with CONFLICT: lines.

The problem with research notes

A long piece, a book or an investigation produces more material than anyone holds in their head. Interview transcripts, PDFs, saved articles, voice memos and half-finished outlines pile up. Three weeks later you remember that someone said something useful, but not who, or whether a second source contradicted it.

Search finds words. It does not tell you which claim rests on which source, which two sources disagree, or which page was written before a source was updated. Cozy is built around those questions.

How the wiki is organized

Cozy gives each person a private wiki and file space. Every account gets "My wiki", and you can create more private workspaces to keep projects apart. There is a web app and a Mac app.

Folders have fixed jobs:

Files can be Markdown, text, JSON or CSV. Curated pages go up to 90,000 bytes, and imported sources up to 1,500,000 bytes.

Getting sources in

You can upload files in the browser (1 MB per file, 25 files per selection), or connect Granola, Italic, Gmail, Google Drive, Notion, Slack and other connectors that write into sources/. If you have a transcript pipeline of your own, push documents to the ingest API with a stable id. Pushing the same id again updates the same source, and sources you delete are never re-imported.

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":"interview-2026-11-02-park","content":"..."}]}'

New documents land in the built-in Inbox, so nothing is filed until you or your agent decides where it goes.

What your agent does with them

Cozy runs no model. You connect your own agent, such as Claude, Codex or ChatGPT, to Cozy's hosted MCP URL, https://cozy.cloud/mcp, and it uses the tools to organize, recall and maintain the wiki. See MCP server for setup and Connect Claude Code for a config example.

A typical session looks like this:

  1. You drop in a new interview transcript.
  2. The agent reads it with cozy_read, then calls cozy_resolve to match the names in it against existing pages.
  3. It updates the person page and the timeline with cozy_edit, and links every new claim to the source file.
  4. If the new interview contradicts an older one, it adds a CONFLICT: line that names both sources instead of overwriting either.
  5. It records what it did in agents/, so the next session starts from the same state.

Edits require an expected revision, so two sessions cannot silently overwrite each other. Deletes are tombstones, and the last 50 revisions of a page can be read and restored.

Citations and conflict lines

A link from a wiki page into sources/ is read as a citation. You write them as ordinary wikilinks, and Cozy builds the graph on every save. A claim line might look like this:

The plant closed in March 2024. [[sources/interview-2026-11-02-park]]
CONFLICT: the county filing gives April 2024. [[sources/county-filing-2024]]

Cozy counts CONFLICT: lines, so open disagreements show up in the health report instead of living only in your memory. Typed relations work too. A person page can carry employer:: [[Acme Plant]], so your agent can ask cozy_context for a page and get its typed neighbors, excerpts, evidence and warnings in one call. More on this in typed links and source citations.

Checking the wiki before you publish

The Health report lists broken links, stale pages (a cited source changed after the page was last edited), conflicts, orphans, unsourced pages, duplicate titles and aliases, and sources nothing cites. It also gives a prioritized list of fixes. For a writer, the useful ones are unsourced pages and open conflicts: they show where a draft still stands on a claim you have not pinned to evidence.

Cozy also describes an offline consolidation pass called dreaming. Your agent orients with cozy_health, looks at only what changed since the last run, checks claims against sources, keeps superseded values with their dates, merges duplicates and records the run. It is a routine you ask your own agent to run, and the output is plain pages you can read and edit.

Privacy and control

Agents connect through OAuth with S256 PKCE and get no more access than you have, capped by the scopes they were granted. You can disconnect them under Connectors → Agents. For scripts, bearer credentials you create in Agents work on a single workspace URL. They are shown once, stored as digests, revocable and expire within 90 days, and you can limit one to read, wiki-write or source-write, and to certain folders. An agent cannot see connector credentials or permanently purge anything. If you handle sensitive source material, read MCP security and privacy first.

Where other tools fit better

Obsidian is a strong choice if you want a local vault that you edit by hand. The core app is free, as listed on its pricing page, and your files stay on your device. The tradeoff is that an agent in a browser or on another machine needs a plugin or tunnel to reach it. See Cozy vs Obsidian. Notion has richer tables and human collaboration, see Cozy vs Notion.

Cozy search is lexical, and there are no embeddings or vector database. If you rely on fuzzy semantic search across a huge archive, that is a real limit. It also means you get a wiki you can read, not an index you cannot inspect.

Getting started

Sign in with an email code, Google or Apple. Add https://cozy.cloud/mcp to your agent as a remote MCP server, approve it on the consent page, and push your first few sources. Ask the agent to build an index and a page per person or organization, then run Health and read the result before you trust the draft.

Frequently asked questions

Does Cozy write my articles or run an AI model?

No. Cozy runs no model. You bring your own agent, such as Claude, Codex or ChatGPT, and it reads and edits your wiki through the hosted MCP server.

How does the wiki show that two sources disagree?

Your agent writes a CONFLICT: line on the page that names both sources, and keeps older values with dates. Cozy counts these lines in the Health report so open disagreements stay visible.

Can I bring in interview transcripts and documents?

Yes. Upload Markdown, text, JSON or CSV files in the browser, connect sources such as Granola or Google Drive, or push documents through the ingest API with a stable id. See source citations for how pages link back to them.

Can my agent delete or leak my research?

Agent credentials are scoped, revocable and expire within 90 days, and they cannot permanently purge. Deletes are tombstones, and the last 50 revisions of a page can be restored. See MCP security.

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