# Koru MCP server

Koru is a workspace app: documents, tasks and notes kept as a tree of typed
nodes. **This address, `https://mcp.koru.do/mcp`, is a Model Context Protocol
(MCP) server.** An assistant connected to it can reach the workspaces a person
syncs with Koru Cloud, with none of their devices switched on.

## What it needs

- A Koru account with **Koru Cloud sync** turned on. The person turns it on in
  the Koru desktop app, under Manage, then Koru Cloud, for each workspace they
  want reachable.
- An assistant that speaks MCP revision **2026-07-28** over Streamable HTTP and
  signs in with OAuth.

## How to connect

Add `https://mcp.koru.do/mcp` as a custom connector (a remote MCP server) in
the assistant:

- **Claude** (web, desktop): Settings, then Connectors, then Add custom
  connector, with this address.
- **Claude Code**: `claude mcp add --transport http koru https://mcp.koru.do/mcp`.
- **ChatGPT**: Settings, then Connectors (developer mode), then create a
  connector with this address.

The assistant then opens koru.do, where the person signs in, chooses which
Profiles the assistant may reach and whether it may only read, and approves.
They can see and revoke the connection on koru.do at any time.

## What an assistant can do once connected

- List the person's Cloud workspaces, and list, search and read their
  documents.
- List tasks.
- On a connection the person approved as Read & edit: create documents, edit
  them (tasks change through an edit), and move content into another
  document. A change is answered saved only once Koru Cloud has it; when Koru
  cannot confirm a save, the answer says so, and the assistant reads the
  document before retrying. Every change records which connection made it.
- On the same connections: claim a document while working on it
  (`claim_document`, `release_document`), so other assistants' changes to it
  are refused until the claim ends. A claim never blocks the person's own
  devices.
- Read `koru://docs/essentials` before anything else; `get_documentation`
  serves the same text to assistants without MCP resources.

## What it cannot do yet

- **Create workspaces, or share them with other people.** Neither is available
  yet, whatever a prompt says.

This page is the same for everyone and reads nothing from any account.