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. |
Capabilities
Features and capabilities supported by this server
| 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, 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
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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