# A hosted Markdown wiki in the cloud

> What a cloud Markdown wiki is, how it differs from Obsidian on your laptop, and how Cozy hosts plain Markdown files that you and your AI agents can both edit.

Updated 2026-11-09. Canonical: https://cozy.cloud/markdown-wiki

> A hosted Markdown wiki keeps your notes as plain Markdown files on a server instead of one laptop, so a browser, a phone and AI agents can all reach the same pages. Cozy is one: files in folders, wikilinks, revision history, and one remote MCP URL per account that Claude, Codex and other agents can read and write.

## What "Markdown wiki in the cloud" means

People searching for "Obsidian in the cloud" usually want three things at once. They want notes stored as plain Markdown so nothing is locked in. They want wikilinks and backlinks so pages connect. And they want to reach the same notes from any device, including from an AI assistant that cannot see a folder on your laptop.

A local vault covers the first two well. The third is where it gets awkward. Obsidian has no official MCP server, and community servers that expose a vault to a web client typically need a VPS, a Cloudflare Tunnel or Tailscale, or Obsidian Sync plus a headless container (see the [Obsidian forum thread on remote MCP](https://forum.obsidian.md/t/remote-mcp-server-for-obsidian/117941)). A hosted wiki moves the files to a server that is always on and puts an agent endpoint in front of it.

## How Cozy works

Cozy is a private wiki and cloud file space for each person and their AI agents. You sign in with an email code, Google or Apple. 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.

Files are Markdown, text, JSON or CSV, organized into four folders:

- `wiki/` holds curated pages and `index.md`.
- `sources/` holds evidence from connectors and importers, with stable IDs, URLs and timestamps. Cozy treats it as untrusted data.
- `skills/` holds editable `SKILL.md` files.
- `agents/` holds agent notes and handoffs.

Curated files can be up to 90,000 bytes and imported sources up to 1,500,000 bytes. In the browser you can upload up to 25 files per selection, 1 MB each.

### The graph comes from Markdown you already write

Cozy rebuilds a link graph on every save. It reads frontmatter such as `type`, `description`, `aliases`, `tags`, `status` and `as_of`. Frontmatter keys whose values are wikilinks become typed relations. So do `relation:: [[target]]` lines. Other links count as `links_to`, and links into `sources/` count as `cites`. Name links resolve by path, file stem, title or alias, ignoring case and accents. Links inside code are ignored. See [typed links](/typed-links) for the full conventions.

## Connecting an agent

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

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

```bash
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`. 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. More detail is on the [MCP server page](/mcp-server).

Agents get tools such as `cozy_search`, `cozy_read`, `cozy_context`, `cozy_graph`, `cozy_write`, `cozy_edit`, `cozy_append` and `cozy_move`. Search is lexical and paginated. Cozy uses no embeddings or vector database.

## Safety for a shared, writable wiki

A wiki that agents can edit needs guardrails that a local folder does not give you.

- **Scoped access.** 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. Bearer credentials for scripts 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. They never exceed your own access.
- **Optimistic concurrency.** Edits carry `expectedRevision` (0 for a new file). A concurrent edit returns a conflict instead of silently overwriting.
- **History.** Deletion is a tombstone. The last 50 revisions are readable and restorable. Moves keep history and return the links that need repair.
- **Limits.** Agents cannot see connector credentials or permanently purge.

## Health checks

Cozy scores each workspace for problems a growing wiki tends to collect: broken links, duplicate titles or aliases, stale pages whose cited source changed after the last edit, conflicts, orphans, pages `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 orders fixes by priority. Read more at [wiki health](/wiki-health).

## Getting existing notes in

You can drag Markdown files into the browser, or push documents through the ingest API:

```
POST https://cozy.cloud/api/wiki/workspaces/$COZY_WORKSPACE/ingest
Authorization: Bearer $COZY_TOKEN
{"documents":[{"id":"...","content":"..."}]}
```

A request takes up to 25 documents of 1.5 MB each. A stable `id` means a re-push updates the same source, and deleted sources are never re-imported. New documents land in the built-in Inbox. If you are coming from a vault, see [import from Obsidian](/import/obsidian).

## Cozy compared with local and hosted options

| Option | Where files live | Agent access |
| --- | --- | --- |
| Obsidian | On your device | Community MCP servers, often with a tunnel |
| Hjarni | Hosted database | Official hosted MCP |
| Cozy | Hosted Markdown files | One hosted MCP endpoint per account, plus per-workspace endpoints for credentials |

Obsidian is free for the core app, and its Sync is $4 per user per month billed annually, per [obsidian.md/pricing](https://obsidian.md/pricing). It is the better choice if you want offline use, a graph view, Canvas, Dataview and the plugin ecosystem. Cozy files are plain Markdown, so you can keep Obsidian as a viewer.

Hjarni is a hosted Markdown notes service with an official MCP server. Its own post says it is a database rather than a folder of files, with no git history or graph view ([hjarni.com](https://hjarni.com/blog/karpathys-llm-wiki-is-right)). Cozy's differences are sources with stable IDs, typed relations, a Health score and restorable revisions. See the full [Obsidian comparison](/compare/obsidian).

## When a hosted wiki is the wrong choice

If you need everything offline, want to self-host on your own hardware, or rely on community plugins, a local vault or a self-hosted wiki fits better. Cozy runs no model itself, so you bring your own agent. It is operated by Coral Sourcing LLC and is not affiliated with Cozy Cloud (cozy.io) or Cozi. Cozy does not publish pricing, so check the site before planning around it.

## Frequently asked questions

### Is Cozy the same as Obsidian in the cloud?

Not exactly. Both use plain Markdown and wikilinks, but Cozy is hosted with a web app, a Mac app and a built-in MCP endpoint, and it has no plugin system. Obsidian is stronger for offline use, graph view and plugins. See the [Obsidian comparison](/compare/obsidian).

### Can I get my files back out?

Cozy stores Markdown, text, JSON and CSV as files, so the content is plain text you can take elsewhere. Deleted pages are tombstoned and the last 50 revisions stay restorable.

### Do I need to run a server or tunnel for my AI agent?

No. Every account has one hosted MCP URL, https://cozy.cloud/mcp, that Claude, Codex and other MCP clients connect to with OAuth. Scripts can use a workspace URL with a bearer credential instead. See [connect Claude Code](/connect/claude-code).

### Does Cozy include an AI model?

No. Cozy runs no model itself. You bring your own agent, and it reads and writes the wiki through MCP or the ingest API.

### Can an agent overwrite my pages by accident?

Edits require an expectedRevision, so a concurrent change returns a conflict instead of overwriting. Credentials can be limited to read access or to folder prefixes, and the last 50 revisions can be restored.
