Drafto MCP Server

Drafto

A note-taking app with notebooks, rich text editing, and auto-save. Available as a web app, iOS + Android apps, and a macOS desktop app — all with offline support.

Live: drafto.eu

Features

• Notebooks — flat list of notebooks to organize notes
• Notes — rich text with auto-save (BlockNote on web, TenTap on mobile/desktop)
• Offline support — mobile and desktop use WatermelonDB locally and sync to Supabase when online
• Authentication — email/password with email confirmation, plus Google and Apple OAuth; admin approval gates new accounts
• Dark mode — system-aware theme toggle, persisted in localStorage
• Evernote import — import notes from .enex files with full content and attachment support
• MCP server — expose your notes to Claude Desktop, Claude Cowork, and other MCP clients via eu.drafto/mcp on the MCP Registry

See docs/features/ for one brief per functional area (code paths, ADRs, testing).

Tech Stack

Architecture deep-dive: docs/architecture/overview.md.

Getting Started

Prerequisites

• Node.js 22+
• pnpm
• A Supabase project + Supabase CLI
• Playwright browsers — pnpm exec playwright install (for E2E)

For mobile dev: Expo CLI, Android SDK, Xcode. For desktop dev: Xcode, CocoaPods (gem install cocoapods), Ruby 3.3.7 via rbenv.

Full first-time setup guide: docs/operations/local-dev-setup.md.

Setup

git clone https://github.com/JakubAnderwald/drafto.git
cd drafto
pnpm install

# Configure web env
cp apps/web/.env.local.example apps/web/.env.local
# Fill in NEXT_PUBLIC_SUPABASE_URL and NEXT_PUBLIC_SUPABASE_ANON_KEY

# Push schema to your Supabase project
supabase link --project-ref <your-project-ref>
supabase db push

# Run the dev server
pnpm dev

Open http://localhost:3000.

Scripts

Dev commands live here. Build / release / deployment commands live in docs/operations/builds-and-releases.md.

Per-app test commands: docs/architecture/testing.md.

Project Layout

apps/
  web/       Next.js web app (App Router)
  mobile/    Expo + React Native iOS/Android
  desktop/   React Native macOS
packages/
  shared/    TypeScript types + constants (@drafto/shared)
supabase/
  migrations/
docs/
  features/       Per-area briefs (auth, notes, editor, sync, search, MCP, …)
  architecture/   System shape (overview, environments, testing)
  operations/     Runbooks (local-dev-setup, builds-and-releases, migrations)
  adr/            Architecture Decision Records
  archive/        Historical plans (not source of truth)

Full index: docs/README.md.

Contributing

All work goes through branches + PRs — see CLAUDE.md for the project conventions (worktree workflow, SOLID, testing requirements, production safety rails). Decisions are recorded in docs/adr/.

License

Private project.