# NoteOperator

> Markdown workspace with MCP access for AI agents and operators.

NoteOperator is a focused Markdown document platform that lets individuals and teams write, organize, and publish notes — and expose them to AI agents via the Model Context Protocol (MCP).

## What NoteOperator does

- **Markdown editor** — Split-pane editor with live preview, formatting toolbar, autosave, and keyboard shortcuts. Supports headings, bold, italic, code blocks, task lists, tables, and all standard Markdown.
- **Document library** — Folder-based organization with drag-and-drop, search, bulk operations, and breadcrumb navigation.
- **Share links** — Any document can be published as a public read-only page at `/share/[id]`. Visibility is toggled per document. Private documents are owner-only.
- **PDF export** — One-click high-fidelity PDF export with theme-aware rendering (light and dark).
- **MCP API keys** — Scoped API keys with `view`, `edit`, and `delete` permissions. AI agents connect using the Model Context Protocol over HTTP with Bearer token auth. The MCP endpoint is `/api/mcp`.
- **Agent tools** — MCP tools: `list_documents`, `get_document`, `create_document`, `update_document`, `delete_document`, `get_share_link`, `list_folders`, `create_folder`, `rename_folder`, `delete_folder`.

## Connecting an AI agent (Claude Code)

```bash
claude mcp add --transport http noteoperator https://noteoperator.yaro-labs.com/api/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"
```

After adding the server, restart Claude Code. The agent can then read, write, and organise your NoteOperator documents in any conversation.

## Limits

- Folder depth: max 3 levels
- Document size: max 100,000 characters

## Authentication

NoteOperator uses OAuth (Google and GitHub). No password sign-in.

## Pricing

Free to use. No account required to view public share links.

## Technology

Built with Next.js, Supabase, TipTap, and CodeMirror. Hosted on Vercel.

## Links

- App: https://noteoperator.yaro-labs.com
- Privacy: https://noteoperator.yaro-labs.com/privacy
- Terms: https://noteoperator.yaro-labs.com/terms