2389-research

Journal MCP — Development skill for Claude Code

Development community

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

How to install Journal MCP

This entry records only its repository, not the path inside it, so there is no exact command to give. Open 2389-research/journal-mcp and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Journal MCP does

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

Alternatives in Development

Mempalace Init — Set up MemPalace — install the package, initialize a palace, register the MCP server with Cursor, and verify e 58.6k ★
Implement Plan — You are tasked with implementing an approved technical plan from thoughts/shared/plans/ 10k ★
Claude Context Mode — An MCP server that sits between Claude Code and these outputs 5.3k ★

README

Private Journal MCP Server

[![Test Coverage](https://github.com/2389-research/journal-mcp/actions/workflows/coverage.yml/badge.svg)](https://github.com/2389-research/journal-mcp/actions/workflows/coverage.yml) [![Coverage](https://img.shields.io/badge/coverage-86.8%25-brightgreen)](https://github.com/2389-research/journal-mcp/actions)

A comprehensive MCP (Model Context Protocol) server that provides Claude with private journaling and semantic search capabilities for processing thoughts, feelings, and insights.

Features

Journaling

Multi-section journaling: Separate categories for feelings, project notes, user context, technical insights, and world knowledge
Dual storage: Project notes stay with projects, personal thoughts in user home directory
Timestamped entries: Each entry automatically dated with microsecond precision
YAML frontmatter: Structured metadata for each entry

Search & Discovery

Semantic search: Natural language queries using local AI embeddings
Vector similarity: Find conceptually related entries, not just keyword matches
Local AI processing: Uses @xenova/transformers - no external API calls required
Automatic indexing: Embeddings generated for all entries on startup and ongoing

Privacy & Performance

Completely private: All processing happens locally, no data leaves your machine
Fast operation: Optimized file structure and in-memory similarity calculations
Robust fallbacks: Intelligent path resolution across platforms

Tech Stack

Core Technologies

Node.js 18+ - Runtime environment with modern JavaScript features
TypeScript 5.0+ - Type-safe development with strict configuration
MCP SDK 0.4.0 - Official Model Context Protocol implementation
@xenova/transformers - Local AI models for semantic embeddings (no external APIs)