goran-arsov avatar

Fresh Jots

goran-arsov/freshjots-mcp

Connects Claude, Cursor, and other MCP clients directly to your Fresh Jots notes via the REST API. You get seven note operations (list, read, create, append, update, delete, move) and four folder operations (list, create, rename, delete). The standout is append_to_note, which lets you accumulate logs, session transcripts, or journal entries to a single note by filename, creating it on first write if needed. Works only with plain text notes, not rich Trix format. Requires a Fresh Jots Dev or Team plan API token. Useful when you want AI output landing in a persistent notebook or need an assistant to search and modify existing notes without leaving your editor.

GitHub stars
1
tools
11
auth
Secret needed
transport
STDIO, HTTP
env vars
2
last updated
Aug 22, 2026

Tools

11 tools

Public tool metadata for what this MCP can expose to an agent.

list_notesNotes — list_notes, read_note, create_note, append_to_note, update_note, delete_note, move_note

Notes — list_notes, read_note, create_note, append_to_note, update_note, delete_note, move_note

No parameter schema in public metadata yet.

read_note

No parameter schema in public metadata yet.

create_note

No parameter schema in public metadata yet.

append_to_noteAppends to a note addressed by an exact filename and creates the note on first write.

Appends to a note addressed by an exact filename and creates the note on first write.

No parameter schema in public metadata yet.

update_note

No parameter schema in public metadata yet.

delete_note

No parameter schema in public metadata yet.

move_note

No parameter schema in public metadata yet.

list_folders

No parameter schema in public metadata yet.

create_folder

No parameter schema in public metadata yet.

rename_folder

No parameter schema in public metadata yet.

delete_folder

No parameter schema in public metadata yet.

Sponsors

Configuration

FRESHJOTS_TOKEN*secret

Fresh Jots API token. Create one at https://freshjots.com/settings/api_tokens (Dev or Team plan).

FRESHJOTS_PASSPHRASEsecret

Optional passphrase for transparent client-side encryption. When set, create_note/append_to_note accept encrypt:true and read_note accepts decrypt:true — Fresh Jots then stores only ciphertext it cannot read.

Readme

freshjots-mcp

smithery badge

A Model Context Protocol (MCP) server for Fresh Jots. It exposes your Fresh Jots notes as MCP tools, so any MCP client — Claude Desktop, Claude Code, Cursor, and others — can read and write them directly. Point your AI agent's output at a Fresh Jots note, log your coding sessions, or let an assistant search and update your notebook, all through the API.

MCP is an open standard for connecting AI assistants to external tools and data — think of it as a universal adapter, so one integration works across every compatible client.

What you can do

The server talks to the Fresh Jots REST API over a bearer token and exposes these tools:

Notes — list_notes, read_note, create_note, append_to_note, update_note, delete_note, move_note

Folders — list_folders, create_folder, rename_folder, delete_folder


View the full README on GitHub

Details

Repository
github.com/goran-arsov/freshjots-mcp
Website
freshjots.com/for/developers
Package
freshjots-mcp
Transport
STDIO, HTTP
Auth
Required
Registry
MCP registry, active