Inkleaf — Bloco de Notas com Integração Claude
ssmm0205/inkleaf
Caderno manuscrito que Claude pode ler e editar em tempo real
Ver no GitHubUm aplicativo de notas local-first que simula a aparência de um caderno manuscrito, permitindo que Claude leia e escreva diretamente nas suas anotações via MCP. A interface mantém a sensação de escrita manual enquanto os dados subjacentes são estruturados e editáveis por agentes de IA.
Instalação
npx convez-ai ssmm0205/inkleaf1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Automatizar transformação de anotações em listas de tarefas estruturadas
- Integrar assistente de IA para organizar e limpar notas manuscritas
- Criar workflows de produtividade híbrida entre papel digital e agentes de IA
Veredito

Projeto bem arquitetado que combina UX de caderno manuscrito com capacidades reais de automação via MCP. Ideal para quem quer manter a fluidez criativa de anotações manuais mas ganhar os benefícios de um assistente de IA integrado — excelente exemplo de design local-first.
README
A tradução para o português deste README ainda está na fila.
🍃 Inkleaf
Your handwritten notebook, that Claude can read and write in.
A local-first note app that looks and feels like a handwritten paper notebook — and exposes your notes to Claude over MCP, so the AI can write back into the page.
Why Inkleaf?
To-do apps and note apps are a solved problem. People still keep paper notebooks anyway — for the feeling. Inkleaf is built around exactly that feeling, and then does the one thing a paper notebook can't:
You jot something down. You open a Claude session. Claude tidies your scribbles into a clean checklist — written into your notebook in handwriting, animated as if drawn by a pen — and you tick the boxes.
The handwriting is a skin over real structured data, so the page stays interactive and an AI agent can actually read and edit it.
How it works
The handwritten look is presentation only. The truth underneath is a small table of Blocks (a text line, or a to-do with a checked state). Claude connects through a local MCP server and does full CRUD on those Blocks — using your Claude subscription, no API key. Every change streams to the open notebook live and animates in handwriting.
Browser (React) ◄── live push (ws) ── Inkleaf web server ── owns ──► SQLite
│ ▲ (Blocks = source of truth)
└──────── edits (REST) ─────────────────►│
│ REST
Claude Desktop / Code ── stdio ── MCP server ──┘ (read · create · update · delete · toggle)
The design decisions behind this are recorded as ADRs:
- ADR-0001 — connect via MCP, not an embedded Agent SDK (subscription, no API key)
- ADR-0002 — handwriting is a skin over structured Blocks, not real ink
- ADR-0003 — the writing animation is mask-reveal, not true stroke order
- ADR-0004 — native two-way Google Tasks/Calendar sync over the primary account (opt-in via OAuth)
The project's domain language lives in CONTEXT.md.
Quickstart
git clone https://github.com/ssmm0205/inkleaf.git
cd inkleaf
npm install
npm run dev # starts the web server (8788) + the UI (5173)
Open http://localhost:5173 and start a note.
Connect Claude
Point Claude at the local MCP server (the web server must be running so the agent's writes show up live):
claude mcp add inkleaf --transport stdio -- npx tsx /ABSOLUTE/PATH/TO/inkleaf/src/mcp/server.ts
Or, for Claude Desktop, add to claude_desktop_config.json:
{
"mcpServers": {
"inkleaf": {
"command": "npx",
"args": ["tsx", "/ABSOLUTE/PATH/TO/inkleaf/src/mcp/server.ts"]
}
}
}
Then ask Claude things like "read my notebook and turn today's scribbles into a checklist" — and watch it write into the page.
Tech stack
| Layer | Choice |
|---|---|
| UI | React 19 + Vite, Nanum Pen Script handwriting font, CSS mask-reveal animation |
| Store | SQLite (better-sqlite3), Blocks as the single source of truth |
| Live updates | ws websocket broadcast |
| Agent bridge | @modelcontextprotocol/sdk (stdio MCP server) |
Status
🌱 Early smoke test. The goal of this phase is to prove one thing: does Claude writing handwriting into your notebook feel like magic? Stroke-order-perfect Hangul, multiple notebooks, real stylus ink, and sync are explicitly out of scope for now (see ADRs).
Contributing
PRs welcome. Issues are tracked on GitHub; the codebase is built test-first around the Block service seam. See CONTEXT.md for the vocabulary before opening a PR.
License
Apache 2.0 © Inkleaf contributors