private-journal-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PRIVATE_JOURNAL_PATH | No | Custom directory path for journal data. If not set, defaults to $XDG_DATA_HOME/private-journal or ~/.local/share/private-journal. | |
| PRIVATE_JOURNAL_GIT_REMOTE | No | Git remote URL for auto-syncing journal entries (e.g., git@github.com:user/repo.git). If set, enables git sync on write and session start. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| write_journalA | Write a durable private journal entry with a meaningful title. section defaults to observations. Pick the section by what the note is about:
Returns a JSON object with the written file path. |
| search_journalA | Search private journal entries semantically and return LLM-readable markdown snippets with source paths, sections, projects, scores, and excerpts. Use section to narrow recall when the intent is known; omit section for broad discovery. Scores are cosine similarities from a multilingual-e5 model and cluster in a narrow band (~0.80-0.89), so a high score alone does not mean an entry is relevant. Always judge relevance from the excerpt text, and treat small score gaps as noise. Results are ordered with an automatic created_at date decay (90-day half-life, 50% floor); score and minScore remain semantic similarity values. Omit project to search across all projects. Use project only when an explicit repository filter is needed; the current runtime project is never applied automatically. |
| read_journalA | Read the full content of a single journal entry by file path returned from search_journal or list_journal. |
| list_journalA | List recent journal entries with paths, dates, sections, and projects for chronological review before reading full entries. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 4 tools
Each tool has a distinct job: writing entries, listing entries chronologically, searching semantically, and reading a specific entry by path. The retrieval tools are separated by mode (recent/chronological vs. semantic), so an agent should not misselect among them.
All tool names follow a consistent verb_journal pattern: read_journal, list_journal, write_journal, search_journal. Naming is uniform, predictable, and clearly conveys each action.
Four tools is a reasonable, focused surface for a journal server. Each tool covers a distinct core operation without redundancy or feature bloat.
The toolset covers writing, browsing, searching, and reading entries, which are the core workflows for a journal system. The absence of update/delete is acceptable for a durable, append-friendly journal design.