krtw00/konbu

Your personal digital planner, kept by an AI butler.
CLI · MCP · Self-hostable · AI-native
One Go binary that binds your memos, todos, schedule, and tables into a single planner — searchable from one place, kept by AI.
Connect Claude, Cursor, or any MCP client to your data.
日本語 | English
---
Try It
- **Cloud** -- Use instantly at konbu-cloud.codenica.dev (free, no setup)
- **Self-hosted** -- Run on your own server with Docker (see below)
What is konbu?
konbu is a **personal digital planner** — a Filofax-style system planner, digitized. A self-hostable Go binary that binds your memos, todos, schedule, and structured tables into one notebook, kept by an AI butler, and surfaces everything from a single search interface. It's yours alone — nothing is ever shared out. Not a replacement for Notion + Todoist + Calendar — a replacement for **the act of searching four apps to find one thing**.
What's different:
- **Native MCP server + CLI client** -- Two parallel routes for the AI butler (Claude / Cursor / any MCP client) or shell / scripts to operate your planner.
- **Cross-resource full-text search** -- One query across memos, todos, events, and structured tables. This is the core UX, not a side feature.
- **Structured tables** (= table-memo, planned) -- Track blood pressure, household budgets, or inventory. Markdown can't express these; tables can.
- **BYOK AI chat** -- Bring your own OpenAI/Anthropic API key, or use the included free tier.
- **Personal by design** -- One notebook, for you only. Pulls in from outside (Google Calendar), never leaks out.
- **Self-hostable** -- One Go binary, Docker compose, or use the hosted version.
End the state of having your day scattered across four different apps.
Features
- **Cross-resource Full-text Search** -- Search across memos, todos, events, and structured tables in one query (core UX)
- **CLI & MCP Server** -- Built-in CLI client and MCP server. AI agents like Claude and Cursor can read and write your data directly
- **AI Agent Chat** -- "Add groceries to my todo" "What's on my schedule tomorrow?" in natural language. BYOK supported, free tier included
- **Memos** -- Markdown notes with tagging, live preview
- **ToDo** -- Inline task creation with due dates, tags, and notes
- **Calendar** -- Monthly view with event CRUD and iCal import (personal, owner-only)
- **Structured Tables** (= table-memo, planned) -- Track structured data (blood pressure, household budget, inventory) as rows × columns
- **Export/Import** -- JSON export, Markdown ZIP export, iCal import
- **i18n** -- English and Japanese
Quick Start
Open http://localhost:8080 and create your account. The dev compose file sets DEV_USER=dev@local to skip registration.
Production (with Traefik)
Native (without Docker)
Configuration
| Variable | Required | Default | Description |
|---|---|---|---|
| DATABASE_URL | Yes | -- | PostgreSQL connection string |
| SESSION_SECRET | Yes | dev fallback | Session signing key |
| PORT | No | 8080 | Server port |
| DEV_USER | No | -- | Auto-login as this email (dev only) |
| OPEN_REGISTRATION | No | -- | Set true to allow anyone to register (for Cloud) |
| BASE_URL | No | -- | Public app URL used for OAuth callbacks |
| GOOGLE_CLIENT_ID | No | -- | Enable Google OAuth login |
| GOOGLE_CLIENT_SECRET | No | -- | Enable Google OAuth login |
| WEBHOOK_SECRET | No | -- | GitHub Sponsors webhook secret |
| STRIPE_SECRET_KEY | No | -- | Enable Stripe checkout and subscription billing |
| STRIPE_WEBHOOK_SECRET | No | -- | Verify incoming Stripe webhook events |
| STRIPE_PRICE_MONTHLY | No | -- | Stripe Price ID used for monthly Pro checkout |
| STRIPE_PRICE_YEARLY | No | -- | Stripe Price ID used for yearly Pro checkout |