# Cozy vs Roam Research for AI agents

> Compare Cozy and Roam Research for agent use: hosted MCP vs desktop-bound MCP, scoped credentials, plain Markdown files, and where Roam's block outliner is still stronger.

Updated 2026-11-09. Canonical: https://cozy.cloud/compare/roam-research

> 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](https://outlinersoftware.com/topics/viewt/12619)).

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

| Topic | Roam Research | Cozy |
| --- | --- | --- |
| Core unit | Block with a UID | Markdown page |
| Official MCP | Alpha, uses the desktop local API | One hosted Streamable HTTP endpoint per account, plus per-workspace endpoints for credentials |
| Desktop app must run | Yes, for the official MCP | No |
| Agent permissions | Full, read-append or read-only per graph token | read, wiki-write, source-write, plus folder-prefix grants |
| Storage | Proprietary graph database | Markdown, text, JSON, CSV files |
| Search | Keyword and semantic (embeddings) | Lexical, paginated |
| Undo | README warns deletes may be hard to undo | Tombstones and last 50 revisions restorable |
| Block references | Yes | No |

Roam facts in this table come from the official [roam-tools README](https://github.com/Roam-Research/roam-tools) and a [2026 Roam review](https://dev.to/onsen/roam-research-review-2026-is-it-still-worth-it-2kin).

## 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](https://github.com/Roam-Research/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](https://github.com/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](/mcp-server) for details.

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

```bash
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

- **Block-level thinking.** Every Roam bullet is addressable and embeddable. Cozy links at the page level only, which is a real loss if your notes depend on block references.
- **Semantic search.** Roam's official MCP can search with embeddings. Cozy search is lexical. It is simpler to inspect, but it will miss fuzzy matches.
- **Maturity and community.** Roam has years of daily-notes workflows and an established user base. Cozy is much newer and has no comparable plugin ecosystem.
- **Datalog queries.** If you already write Datalog against your graph, Roam keeps that power.

## Where Cozy is the better fit

- **No desktop dependency.** A hosted endpoint means cloud agents and chat clients can connect directly.
- **Governed access.** Scopes, folder prefixes, expiry and revocation are enforced by the server per request, not by a tag convention.
- **Recoverable writes.** Edits require an `expectedRevision`, concurrent edits return a conflict, deletions are tombstones, and the last 50 revisions are readable and restorable.
- **Plain files.** Markdown, text, JSON and CSV. The 2026 review above lists data portability as a hidden cost of Roam. In Cozy the files are the source of truth.
- **Typed relations and Health.** Frontmatter keys whose values are wikilinks, `relation:: [[target]]` lines and triples become typed edges. Health reports broken links, stale pages, conflicts and orphans. See [typed links](/typed-links).

## 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](/import/roam-research) 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](/compare) and [Cozy vs Logseq](/compare/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](https://github.com/Roam-Research/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](/mcp-server).

### 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](/import/roam-research) 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.
