Guides
A personal wiki for you and your AI agents
A personal wiki for you and your AI agents is a set of linked Markdown pages that you read and your agents read and write through a shared endpoint. Cozy hosts one wiki per account, called "My wiki", and gives each account one MCP URL for all its workspaces. You bring the agent, such as Claude, Codex or Cursor.
What a personal wiki is for
A personal wiki is a place where facts about your work, projects and people live as pages that link to each other. Classic personal wiki software assumed one reader and one writer: you. That assumption is breaking down. Now an agent in Claude Code, Codex or a chat app also wants to look things up, and sometimes to add notes after a long session.
If the wiki is a closed app or a vault on one laptop, each agent starts from nothing. If it is a hosted set of plain files with an agent endpoint, every session can pick up where the last one stopped. That is the idea behind a personal wiki app with AI: the notes stay yours, and the agent is a second contributor.
What a wiki needs once agents write to it
Agents write quickly and do not always notice what they overwrote. These are the properties that matter once a model is a regular author.
- Plain files. Pages are Markdown, text, JSON or CSV, so you can read, diff and take them elsewhere.
- Safe edits. Every edit carries an expected revision, and a concurrent edit returns a conflict instead of silently winning. Deletes are tombstones, and the last 50 revisions of a file can be read and restored.
- Structure from the text. Links, tags and typed relations come from Markdown conventions, so the agent does not need a separate database.
- Evidence. Claims should point back to a source, and you should be able to tell when the source changed.
- A way to notice rot. Broken links, duplicates and stale pages pile up fast when an agent adds pages daily.
- Scoped access. The agent should get the least access that does the job, and you should be able to revoke it.
How Cozy works
Every account gets "My wiki". You sign in with an email code, Google or Apple, and use the web app or the Mac app. You can create more private workspaces to keep projects apart. Cozy is single-player, so only you and the agents you authorize can access them.
A workspace is organized into four folders:
| Folder | What it holds |
|---|---|
| wiki/ | Curated pages and index.md |
| sources/ | Evidence from connectors and importers, with stable IDs, URLs and timestamps |
| skills/ | Editable SKILL.md files for your agents |
| agents/ | Agent notes and handoffs |
Curated files can be up to 90,000 bytes. Imported sources can be up to 1,500,000 bytes. Content in sources/ is treated as untrusted data, not as instructions.
The graph comes from Markdown
On every save, Cozy reads frontmatter such as type, description, aliases, tags, status and as_of. Other frontmatter keys whose values are wikilinks become typed relations. A line like relation:: [[target]] also works. Plain links count as links_to, and links into sources/ count as cites. Links resolve by path, file stem, title or alias, ignoring case and accents, and anything unresolved is reported as broken. See typed links for the details.
Health
Cozy scores the wiki from the issues it finds: broken links, duplicate titles or aliases, stale pages whose cited source changed after the last edit, conflicts, orphans, pages that index.md cannot reach, unsourced pages, missing type or description, oversized pages and uncited sources. Each page starts at 1.0 and loses weight per issue. The score is the average times 100, and a "next" list gives fixes in priority order. More in wiki health.
Connecting your agents
Every account has one MCP endpoint, https://cozy.cloud/mcp, for all your workspaces. Clients sign in with OAuth 2.1 and you approve access on Cozy's consent page. Tools use My wiki unless the agent passes a workspace argument, and cozy_workspaces lists the workspaces you can use. It is stateless Streamable HTTP.
For Claude Code, run this once, then sign in with /mcp:
claude mcp add --transport http --scope user cozy https://cozy.cloud/mcp
For Codex, run this. It opens a browser to sign in; if it does not, run codex mcp login cozy:
codex mcp add cozy --url https://cozy.cloud/mcp
In claude.ai or ChatGPT, add a custom connector with the URL https://cozy.cloud/mcp. An OAuth agent gets no more access than you have in each workspace, capped by the scopes it was granted (wiki:read, wiki:write, sources:write). Connected agents are listed and can be disconnected under Connectors → Agents.
For scripts, CI and headless agents, each workspace also has its own endpoint at https://cozy.cloud/wiki-mcp/WORKSPACE_UUID, used with a bearer credential created under Agents. Bearer credentials are shown once, stored as SHA-256 digests and expire within 90 days. They carry the scopes read, wiki-write or source-write, can be limited to folder prefixes, and never exceed your own access. Agents cannot see connector credentials or permanently purge. Setup guides: Claude Code, Codex, Cursor.
The tools include cozy_search, cozy_read, cozy_context, cozy_graph, cozy_write, cozy_edit, cozy_append, cozy_history and cozy_restore. The cozy_context tool returns a page with its typed neighbors, excerpts, evidence and warnings. Search is lexical. Cozy does not use embeddings or a vector database.
Getting material in
You can upload Markdown, text, JSON or CSV in the browser, up to 1 MB per file and 25 files per selection. You can also push documents to the ingest API with a stable id, so a re-push updates the same source. New documents land in the built-in Inbox. Connectors cover Granola, Italic, Gmail, Google Calendar, Google Drive, Outlook mail and calendar, Notion, Slack for selected channels, Linear, Ramp, Apple Reminders on the Mac, and Custom MCP.
Where other tools fit better
Cozy runs no model itself, so it does not answer questions until you connect an agent. It is a younger product than the tools below, and it has no real-time co-editing claim to compare with Notion.
- Obsidian is local-first, and its core app is free with no sign-up, per its pricing page. If you want a vault on your own disk with a large plugin ecosystem, it is a good fit. See Cozy vs Obsidian.
- Notion has richer databases and human collaboration, and its hosted MCP is documented at developers.notion.com. See Cozy vs Notion.
- Capacities is built for an individual's object-based notes and documents a hosted MCP endpoint of its own on its site. See Cozy vs Capacities.
Who it suits
Cozy suits people who already work with coding or chat agents and want one durable place those agents can read and write. If you only want a quiet notebook for yourself, a local app is simpler. Start with llm wiki for the underlying pattern, or agent memory if your main problem is agents forgetting. For privacy details, see privacy.
Frequently asked questions
What is a personal wiki app with AI?
It is a wiki of linked pages that an AI agent can read and write, not only you. In Cozy the agent connects over a hosted MCP endpoint, and you bring the model yourself.
Does Cozy include its own AI model?
No. Cozy runs no model itself. You connect your own agent, such as Claude, Codex or Cursor, and it works on your wiki through the MCP tools.
Are my pages locked into Cozy?
Pages are stored as Markdown, text, JSON or CSV files. You can read the format directly, and markdown wiki explains the conventions Cozy uses.
Can an agent delete or ruin my wiki?
Agents get scoped credentials that you can revoke, and they cannot permanently purge. Deletes are tombstones, and the last 50 revisions of a file can be restored.
Can I share the wiki with other people?
No. Cozy is single-player: there are no shared workspaces, invitations or roles. Every account has "My wiki", and you can create more private workspaces to keep projects apart. Only you and the agents you authorize can access them.
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