# Peerdraft

> Open your Obsidian notes to people, tools, and AI agents

Peerdraft is the collaboration layer between Obsidian and everything else. Connect your notes to other people and devices via real-time Obsidian-to-Obsidian sync and web editor, to tools via RESTful API, and to AI agents via MCP integration. Supports both real-time collaboration and asynchronous workflows. Changes sync automatically whether you're working together or independently. Built on Yjs CRDTs with end-to-end encryption for fleeting sessions or persistent sharing with offline support.

## How to Access

- **Obsidian Plugin**: Install from Community Plugins, share documents via right-click menu
- **Web Editor**: Browser-based access for collaborators (no account required)
- **RESTful API**: Programmatic access at `/api/v1/docs`
- **MCP Server**: AI agent integration via streamable HTTP endpoint at `https://www.peerdraft.app/mcp/SPACE_ID`

**Note**: Only the creator of a shared document or folder (Peerdraft Space) needs an account. Collaborators can access shared content without signing up.

## Use Cases

- **Research teams**: Collaborative literature reviews with shared Obsidian vaults
- **AI-assisted writing**: Let Claude/ChatGPT read and edit your notes via MCP
- **Task automation**: Sync Obsidian tasks with external project management tools via API
- **Knowledge bases**: Share documentation with non-Obsidian users via Web Editor
- **Meeting notes**: Real-time collaborative note-taking during meetings
- **Content generation**: Enable AI agents to summarize, organize, and update your documents

## Features

- [Web Editor](https://www.peerdraft.app/#web-editor): Browser-based collaboration for non-Obsidian users
- [Persistent Sharing](https://www.peerdraft.app/documentation/explanations/what-is-the-difference-between-persistent-and-fleeting): Long-term collaboration with offline support and background sync
- [Fleeting Sessions](https://www.peerdraft.app/documentation/explanations/what-is-the-difference-between-persistent-and-fleeting): End-to-end encrypted WebRTC sessions for temporary collaboration
- [Folder Sharing](https://www.peerdraft.app/#features): Share entire folders (including subfolders), not just individual documents
- [Canvas Collaboration](https://www.peerdraft.app/#features): Real-time collaboration on Obsidian Canvas (beta)
- [Background Sync](https://www.peerdraft.app/#features): Automatically detects changes from AI tools or external editors
- [RESTful API](https://www.peerdraft.app/api/v1/docs): Programmatic access to shared documents for tool integration
- [MCP Integration](https://www.peerdraft.app/documentation/how-to-guides/getting-started-with-the-peerdraft-mcp): Connect AI agents to your shared Obsidian folders via Model Context Protocol

## MCP Setup

Each shared Space (folder) exposes an MCP endpoint via streamable HTTP:

```
https://www.peerdraft.app/mcp/SPACE_ID
```

To get your Space ID, right-click your shared folder in Obsidian and select "Peerdraft -> Copy URL". Replace `team` with `mcp` in the URL.

**Supported clients**: Claude (web/desktop/mobile), ChatGPT (Business/Enterprise), Cursor, Windsurf, LibreChat, Jan

**Example configuration** (Cursor):
```json
{
  "mcpServers": {
    "my-space": {
      "url": "https://www.peerdraft.app/mcp/YOUR_SPACE_ID"
    }
  }
}
```

See [MCP setup guide](https://www.peerdraft.app/documentation/how-to-guides/getting-started-with-the-peerdraft-mcp) for detailed instructions.

## Technical Architecture

- Built on Yjs CRDTs for conflict-free real-time synchronization
- End-to-end encryption via WebRTC for fleeting sessions (zero-knowledge, servers never see content)
- HTTPS encryption for persistent shares (server-side encryption in transit and at rest)
- Local-first architecture with universal access (Obsidian, web, API, MCP)
- Background sync automatically merges changes from any source

## Pricing

- **Free**: 10 persistent shares, unlimited fleeting sessions
- **Trial**: 10,000 persistent shares (14-day Pro trial for Free tier users)
- **Pro**: 10,000 persistent shares, all collaborators free forever
- **Business**: Unlimited persistent shares

## Documentation

- [API Reference](https://www.peerdraft.app/api/v1/docs): Complete REST API documentation
- [MCP Setup Guide](https://www.peerdraft.app/documentation/how-to-guides/getting-started-with-the-peerdraft-mcp): Connect AI agents to your Spaces
- [Getting Started](https://www.peerdraft.app/documentation/how-to-guides/getting-started-with-obsidian): Install and configure the Obsidian plugin
- [Privacy Policy](https://www.peerdraft.app/privacy): GDPR and CCPA compliance
- [Terms of Service](https://www.peerdraft.app/terms): Legal agreement