Skip to main content
Glama
baleen37

private-journal-mcp

by baleen37

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
PRIVATE_JOURNAL_PATHNoCustom directory path for journal data. If not set, defaults to $XDG_DATA_HOME/private-journal or ~/.local/share/private-journal.
PRIVATE_JOURNAL_GIT_REMOTENoGit 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.

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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:

  • project_notes: current repo/task state, decisions, and where work stands.

  • technical_insights: reusable fixes, root causes, and gotchas worth recalling later.

  • user_context: stable preferences and working style of the person you assist.

  • observations: raw findings from this session that are not yet generalized.

  • reflections: retrospectives on how the work went and what to change next time.

  • world_knowledge: durable facts about systems or the world outside this repo.

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, 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. minScore is available but has no reliable universal cutoff.

read_journalA

Read the full content of a single journal entry by file path returned from search_journal or list_journal.

list_journalB

List recent journal entries with paths, dates, and sections for chronological review before reading full entries.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/baleen37/private-journal-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server