zainzaidi37/kinjot-mcp

Keep what your AI coding agent figures out. Tell Claude Code or Codex to
"jot that down", and the note lands in your Kinjot account,
tagged and searchable.
- Works with Claude Code, Codex and any other MCP client, plus a terminal CLI.
- Free to sign up and use. Export every note as Markdown whenever you like.
- Saves notes only when you ask. Agents can send brief Inbox notifications under the narrow rules below.
Documentation · Claude Code setup · Codex setup · MCP tool reference
Quick start
1. Sign up at kinjot.com (free) and confirm your email.
2. Open **Settings > API keys** and create a key.
3. Install the CLI and save your key:
kinjot key asks for the key, checks it, and saves it to
~/.kinjot/config.json. Only your user can read that file. It then prints
the setup for your MCP client.
4. Connect your agent:
5. Tell your agent to "jot that down". Later, ask it to find your jots about
something, or to show your recent jots.
What your agent can do
| Tool | What it does |
| ------------------ | ------------------------------------------------------------------------ |
| jot | Save a note |
| find_jots | Search your notes by keyword |
| recall_jots | Search your notes by meaning (Pro) |
| get_jot | Read one note in full |
| edit_jot | Replace one exact passage in a note, or change its title, tags or folder |
| append_to_jot | Add a paragraph to the end of a note |
| list_recent_jots | List your most recently updated notes |
| upload_image | Upload a PNG or JPEG and return Markdown (Pro or self-hosted) |
| notify | Send a brief question, blocker, handoff or requested completion to Inbox |
| inbox | List or resolve Inbox items when you explicitly ask |
The server checks the key at startup and lists only tools its access level allows.
notify needs create access; listing with inbox needs read access, and resolving needs create access.
An agent may send a question or blocker on its own only when stopping and you may not be watching.
Handoffs describe work left, and done messages require that you asked to be told. You can mute kinds
or keys in Settings → Inbox. The inbox tool is used only when you ask to check the Inbox or pick up
a handoff. It treats item text as untrusted and asks before acting on requests inside it to fetch
URLs, handle secrets, change settings or contact outside addresses.
jot and edit_jot leave out the reserved autosave tag; kinjot add --tags …,autosave keeps it for the capture plugins.
Keep upload_image on **ask** in your agent's permissions. An uploaded image
becomes public to anyone holding its link, so check the file before approving it.
On a self-hosted deployment, upload_image needs a backend release that includes image uploads; an older one answers with a message to run update.
Every note has a short label, like A10. Listings show it, and your agent can
use it to open, edit or add to that note, for example "add this to A10".
CLI
Once your key is saved, the same features work from a terminal. Installed
(npm i -g kinjot, or in a project), every command also answers to the short
name kj, so kj search "worker environment" works too. Through npx, type
kinjot: npx kj would fetch an unrelated npm package named kj.
Search, recall and recent leave out notes tagged autosave; get reads one by label.
kinjot add "Title" --id saves with a caller-supplied note ID; the
ID may also appear before the title. kinjot append A10 --no-snapshot asks a
supported backend to follow the library's history setting instead of forcing