private-journal-mcp

Provides an MCP server (stdio via npx) that lets an agent write private, timestamped journal entries to local files (with YAML frontmatter) and perform local semantic search over those entries using embeddings generated with @xenova/transformers.

Evaluated Mar 30, 2026 (21d ago)
Repo ↗ Ai Ml mcp journal local-ai semantic-search personal-knowledge-management typeScript offline
⚙ Agent Friendliness
60
/ 100
Can an agent use this?
🔒 Security
26
/ 100
Is it safe for agents?
⚡ Reliability
22
/ 100
Does it work consistently?

Score Breakdown

⚙ Agent Friendliness

MCP Quality
78
Documentation
72
Error Messages
0
Auth Simplicity
95
Rate Limits
10

🔒 Security

TLS Enforcement
20
Auth Strength
15
Scope Granularity
10
Dep. Hygiene
55
Secret Handling
40

The design appears local/offline with no external API calls mentioned, which reduces data-in-transit risk. However, there is no documented authentication/authorization, and MCP runs locally via stdio; anyone who can invoke the MCP process can likely access/write the journal files. The README implies embeddings and journaling are stored on disk (including per-project and user home directories), so confidentiality depends on host security (filesystem permissions, device security). No guidance is provided on encryption-at-rest, file permissions, or safe handling of sensitive content.

⚡ Reliability

Uptime/SLA
0
Version Stability
35
Breaking Changes
30
Error Recovery
25
AF Security Reliability

Best When

Used by a single user locally (e.g., Claude Desktop) where privacy is achieved by keeping data on the host machine and where lightweight semantic search is sufficient.

Avoid When

When you need strong authentication/authorization controls, centralized governance, or when the host environment cannot be trusted with sensitive personal data written to disk.

Use Cases

  • Private journaling for thoughts/feelings
  • Semantic retrieval of past entries for reflection or planning
  • Maintaining per-project and global journal areas
  • Offline/local processing of embeddings and search

Not For

  • Cloud-based shared journaling or collaboration across users
  • Storing sensitive data with strong security guarantees without additional hardening
  • High-throughput or multi-tenant deployments requiring robust API security

Interface

REST API
No
GraphQL
No
gRPC
No
MCP Server
Yes
SDK
No
Webhooks
No

Authentication

Methods: No authentication described for MCP/stdio mode (tool runs locally via npx).
OAuth: No Scopes: No

README describes running via `npx` with MCP stdio; no auth scheme, API keys, or access control is documented.

Pricing

Free tier: No
Requires CC: No

No hosted service or pricing details provided; appears to run locally.

Agent Metadata

Pagination
limit-based (functions accept limit and days; no cursor described).
Idempotent
False
Retry Guidance
Not documented

Known Gotchas

  • Running via `npx` means the agent environment must allow executing GitHub packages; network access may be needed for initial retrieval.
  • Local embeddings/index generation on startup can be slow; first-run latency may affect agent workflows.
  • Search results reference file paths; agents should treat returned paths carefully to avoid unintended file reads.
  • No documented rate limiting/auth—misconfiguration or misuse could lead to excessive disk writes or local resource exhaustion.

Alternatives

Full Evaluation Report

Comprehensive deep-dive: security analysis, reliability audit, agent experience review, cost modeling, competitive positioning, and improvement roadmap for private-journal-mcp.

AI-powered analysis · PDF + markdown · Delivered within 30 minutes

$99

Package Brief

Quick verdict, integration guide, cost projections, gotchas with workarounds, and alternatives comparison.

Delivered within 10 minutes

$3

Score Monitoring

Get alerted when this package's AF, security, or reliability scores change significantly. Stay ahead of regressions.

Continuous monitoring

$3/mo

Scores are editorial opinions as of 2026-03-30.

8642
Packages Evaluated
17761
Need Evaluation
586
Need Re-evaluation
Community Powered