Cozy vs Roam Research for AI agents

Updated · By the Cozy team

Cozy is a hosted wiki with a first-party MCP endpoint, so any agent can read and write it without a desktop app running. Roam's official MCP is Alpha and needs the Roam desktop app open, while community servers run headless. Choose Roam for block-level outliner thinking. Choose Cozy when agents need scoped, revocable access to plain Markdown.

We make Cozy, so read this with that in mind. This page covers where each tool fits for people who work with AI agents, and it says where Roam is the better choice.

The short version

Roam Research is an outliner built around blocks, daily notes and bidirectional links. It popularized block-level references, and forum users in 2026 still describe its block linking and filtering as leading class (Outliner Software forum).

Cozy is a private wiki and file space for each person and their agents. Pages are Markdown files. The graph is derived from the Markdown on every save, and agents reach the wiki through a hosted MCP server. Cozy runs no model itself, so you bring your own agent.

Side by side

TopicRoam ResearchCozy
Core unitBlock with a UIDMarkdown page
Official MCPAlpha, uses the desktop local APIOne hosted Streamable HTTP endpoint per account, plus per-workspace endpoints for credentials
Desktop app must runYes, for the official MCPNo
Agent permissionsFull, read-append or read-only per graph tokenread, wiki-write, source-write, plus folder-prefix grants
StorageProprietary graph databaseMarkdown, text, JSON, CSV files
SearchKeyword and semantic (embeddings)Lexical, paginated
UndoREADME warns deletes may be hard to undoTombstones and last 50 revisions restorable
Block referencesYesNo

Roam facts in this table come from the official roam-tools README and a 2026 Roam review.

How agents connect to Roam

Roam's official MCP server and CLI are labeled Alpha. They use the Roam Desktop local API, so the desktop app has to be running, and they do not work with the web version. Tokens are per graph and stored locally (roam-tools).

The official tools cover creating, updating, moving and deleting pages and blocks, keyword and semantic search, raw Datalog queries and more. Semantic search needs embeddings enabled and a signed-in user. The README sets the default token to full read and write, and warns that deletions may be hard or impossible to undo.

Community servers such as 2b3pro/roam-research-mcp use Roam's backend API with a token and graph name, and can run headless. Their README documents breaking changes between major versions, so you take on the job of keeping a third-party package patched. It also calls its privacy tags "a convenience filter, not a security guarantee", and notes that raw Datalog queries bypass them.

How agents connect to Cozy

Every account has one hosted MCP URL, https://cozy.cloud/mcp, for all of its workspaces. It is stateless Streamable HTTP, so it works from Claude, Codex, Claude Code and other clients with nothing running on your machine. See the MCP server page for details.

For Claude Code, add it once and then sign in with /mcp:

claude mcp add --transport http --scope user cozy https://cozy.cloud/mcp

Clients sign in with OAuth 2.1, and an 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 and headless agents, each workspace also has an endpoint at https://cozy.cloud/wiki-mcp/WORKSPACE_UUID that takes a bearer credential created in Agents. Credentials are random, shown once, stored as SHA-256 digests, revocable, and expire within 90 days. Scopes are read, wiki-write and source-write, with optional folder-prefix grants, and they never exceed your own access. Agents cannot see connector credentials or permanently purge.

Where Roam is better

Where Cozy is the better fit

Moving from Roam

Cozy accepts Markdown, text, JSON and CSV through the browser (up to 1 MB per file, 25 files per selection) and through an ingest API. The Roam import guide covers the steps. Because Cozy has no block references, plan to decide which block-level structure you want to flatten into pages.

Pricing

Roam's pricing figures disagree across third-party sources and we could not confirm them from Roam's own page, so we do not quote one. Check roamresearch.com directly. Cozy has no public pricing page to quote here either.

Choose Roam or Cozy

Choose Roam if you think in outlines, rely on block references, and mostly work yourself in the app. Choose Cozy if your agents do much of the reading, writing and upkeep, and you want hosted access with narrow, expiring credentials and restorable history. For other tools in this space, see the comparison index and Cozy vs Logseq.

Frequently asked questions

Does Roam Research have an MCP server?

Yes. Roam publishes an official MCP server and CLI, labeled Alpha, that needs the Roam desktop app running (roam-tools). Community servers also exist and can run headless.

Can Cozy replace Roam Research?

For agent-maintained notes it can, since Cozy offers wikilinks, backlinks and a hosted MCP. It does not support block-level references, so outliner-heavy workflows may fit Roam better.

Do I need a desktop app to connect an agent to Cozy?

No. Your account has one hosted Streamable HTTP MCP URL, https://cozy.cloud/mcp, so agents connect over the network. See the MCP server page.

Can I bring my Roam notes into Cozy?

Cozy takes Markdown, text, JSON and CSV files by upload or ingest API. The Roam import guide explains the steps.

How much do Roam and Cozy cost?

Roam's price figures conflict across third-party sources, so check roamresearch.com. Cozy has no public pricing to state on this page.

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