notectl
Notes from your Terminal
Notes and daily notes via MCP — Obsidian, Apple Notes, or Joplin, synced individually or together. Works on macOS and Linux. 8 MCP tools for AI-powered note-taking.
The terminal app
Type notectl — this is the real TUI with made-up demo data. T switches the colour theme.
notectl Sun 18 Oct All Daily 1 Inbox 1 Personal 2 Projects 2 Work 1 ────────────────────────────────────────────────────────────────────────────────────────────────────────────────────── ── Today ──────────────────────────────── │ Roadmap Q4 ▌ 15:00 Roadmap … Projects #work │ 13:00 Landing … Projects #work │ • Ship [[Landing page]] 11:00 Meeting notes Work #work │ • Theme switcher in every tool │ ── Yesterday ──────────────────────────── │ See [[Meeting notes]]. Sat 20:00 Reading … Personal #home │ Sat 10:00 Weekend … Personal #home │ Sat 14:00 Daily 2026… Daily #daily │ │ ── Friday ─────────────────────────────── │ Fri 14:00 Ideas Inbox │ │ │ enter open n new ? help q quit / search s sync e edit d delete u undo y copy tab notebook 1/7 date
Features
Obsidian Vault Support
Works directly with your existing Obsidian vault. No migration, no sync conflicts — reads and writes standard Markdown files.
Daily Notes
Auto-create and open today's daily note with your template. AI can append to your daily log via MCP.
Full-text Search
Search across your entire vault instantly. Returns ranked results with context snippets.
Tag-based Filtering
Filter notes by Obsidian tags, links, or frontmatter fields. Great for project-scoped AI workflows.
Apple Notes Sync (macOS)
Optional source backend alongside Obsidian/Joplin/Markdown. Reads and writes native Apple Notes over AppleScript — no export step.
Joplin Support
Reads and writes Joplin notes via its local Data API — including nested notebooks (Parent/Child paths), created automatically if they don't exist yet. Requires Joplin running with Web Clipper enabled.
Sync Multiple Sources at Once
sync_sources combines Obsidian, Apple Notes, and Joplin into one browsable cache — e.g. Apple Notes + Joplin together. Writing a new note still targets exactly one source, chosen via `source`.
Multiple Vaults (Bundle)
notectl vault add/list/use manages several named vaults and switches between them. The free tier includes one; more unlocks with the missionctl Bundle.
Real Checklist State (macOS)
Checked/unchecked status for Apple Notes checklists isn't exposed by AppleScript at all — notectl reads it straight from Notes' own local database, so ☑ and ☐ in the terminal always match what you see in the Notes app.
Command Palette
Press ":" and type an action by name — new note, sync, browse tags — instead of memorizing shortcuts. Live-filtered as you type.
Apple Notes checklists, done right
AppleScript's body of note doesn't expose whether a list item is checked — or even whether it's a checklist at all. Most tools that bridge Apple Notes either can't show checkbox state or fake it.
notectl reads it straight from Notes' own local database instead, so the terminal always matches what's actually checked in the Notes app — no guessing, no stale state.
Command Reference
MCP Tools
Available via notectl mcp
Ready to give your AI hands?
Free and open source. Or get the lifetime Bundle for all 9 tools — launch special: -30% with code L4uNch26.