Konbu
@krtw00
A self-hostable all-in-one planner combining calendar, notes, todos, and bookmarks. Built-in MCP server lets Claude Desktop, Cursor, and any MCP client operate your personal data via natural language. Single Go binary, MIT licensed.
概要
What is Konbu?
Konbu is a self-hostable digital planner that combines Notion, Todoist, and Google Calendar into a single Go binary. It includes a native MCP server that lets AI agents like Claude Desktop and Cursor read and write your data directly.
How to use Konbu?
After running a Konbu API server (self-hosted or using the cloud version), add the provided JSON configuration to your MCP client’s mcpServers block. The KONBU_API environment variable points to the server URL, and KONBU_API_KEY must be generated from the web UI’s Settings > Security.
Key features of Konbu
- Native MCP server for natural language task management.
- CLI client with commands like
konbu memo addandkonbu todo list. - Bring your own OpenAI/Anthropic API key or use the free tier.
- Cross-resource full-text search across memos, todos, events, and bookmarks.
- Self-hostable with Docker or use the hosted version at konbu-cloud.codenica.dev.
- Supports calendar, Markdown notes, todos, bookmarks, AI chat, and export/import.
Use cases of Konbu
- Schedule a dentist appointment by speaking naturally to an AI agent.
- Manage all tasks, notes, and events from a terminal using the CLI.
- Search across multiple resource types (memos, todos, events) in one query.
- Run a fully offline planner on your own server with PostgreSQL.
FAQ from Konbu
What exactly does Konbu do?
It is an all-in-one digital planner that merges calendar, notes, todos, and bookmarks, and exposes them via an MCP server for AI agents.
How do I set up the MCP server?
After running a Konbu API server, add the JSON block shown in the README to your MCP client config, setting KONBU_API and KONBU_API_KEY. Generate the API key in Settings > Security on the web UI.
What are the runtime requirements?
Konbu is a single Go binary. It uses PostgreSQL as its database. You can run it with Docker for self-hosting.
Can I use Konbu without hosting my own server?
Yes, there is a hosted version available at konbu-cloud.codenica.dev.
How does authentication work for the MCP server?
The MCP server requires an API key passed via the KONBU_API_KEY environment variable. The key is generated from the web UI’s Settings > Security.
