Advertise
MCP.so
Sign In

Private Journal MCP Server

@obra

Repository

Basic information

Category

Other

Transports

stdio

Author

obra

About Private Journal MCP Server

A lightweight MCP server that provides Claude with a private journaling capability to process feelings and thoughts

#private-journal#mcp-server#journaling

Private Journal MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "private-journal-mcp": {
      "command": "npx",
      "args": [
        "github:obra/private-journal-mcp",
        "--journal-path",
        "/path/to/journals"
      ]
    }
  }
}

Private Journal MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

Fetch the live tool list by running this server in a temporary sandbox using the button above.

Overview

What is Private Journal MCP Server?

The Private Journal MCP Server is a Model Context Protocol server that provides Claude with private journaling and semantic search capabilities for processing thoughts, reflections, and insights. It uses local AI embeddings for search and stores entries in structured markdown files with YAML frontmatter.

How to use Private Journal MCP Server?

Run the server directly from GitHub using npx with no installation required. Add it to your MCP settings (e.g., Claude Desktop configuration) by specifying "command": "npx" and "args": ["github:obra/private-journal-mcp"]. Optionally set the PRIVATE_JOURNAL_PATH environment variable or the --journal-path CLI argument to override the storage location.

Key features of Private Journal MCP Server

  • Multi-section journaling with six optional categories (reflections, observations, project_notes, user_context, technical_insights, world_knowledge)
  • Semantic search using local AI embeddings (no external API calls)
  • Automatic indexing of all entries on startup and ongoing
  • Completely private; all processing stays on your machine
  • Dual storage: project notes stay with the project, personal thoughts in user home directory
  • Timestamped entries with YAML frontmatter and microsecond precision

Use cases of Private Journal MCP Server

  • Capture technical insights, failed approaches, and architectural decisions during development
  • Maintain a personal reflection journal with structured categories
  • Search across past journal entries using natural language queries
  • Build persistent memory for Claude across conversations
  • Document user context and collaboration patterns

Frequently asked questions

1

How does the server ensure privacy?

All processing happens locally using @xenova/transformers; no data leaves your machine and no external API calls are required.

2

Where are journal entries stored?

Project notes are stored in a `.private-journal/` directory within the project. Personal thoughts go into `~/.private-journal/` in the user's home directory. Each entry is a markdown file with a corresponding `.embedding` file for search indexing.

3

How can I change the storage location?

Set the `PRIVATE_JOURNAL_PATH` environment variable to override all journal storage to a single directory, or use the `--journal-path` CLI argument to override only the project journal path.

4

What tools does the server provide?

The server provides four MCP tools: `process_thoughts` for multi-section journaling, `search_journal` for semantic search, `read_journal_entry` to read full entries, and `list_recent_

Comments

More Other MCP servers

The Living Bread

The Living Bread

A free remote MCP server for The Living Bread. Bible passages read word for word from a stored public domain text with an evidence label, keyword search and cross references, real churches, gatherings and prayer groups w

Blender

ahujasid

Open-source MCP to use Blender with any LLM

23.6K

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

DeepMark

DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.

Advertise