Supports containerized deployment of the journal MCP server and web viewer
Stores journal entries in Markdown format with YAML frontmatter, supporting automatic tag extraction and time-based organization
Provides a web-based viewer interface for browsing journal entries with server-side rendering support
Uses YAML frontmatter in journal entries for metadata storage and organization
Journal MCP Server
A Model Context Protocol (MCP) server for journal entries with a React Router v7 web viewer.
Features
📖 MCP Server: Integration with Claude Desktop for journal management
🌐 Web Viewer: React-based interface for browsing journal entries
🚀 Server-side rendering with React Router
⚡️ Hot Module Replacement (HMR) for development
🔒 TypeScript by default
🎉 TailwindCSS for styling
📁 File-based storage with automatic organization
Related MCP server: ClaudeKeep
Getting Started
Quick Start with npx
Run directly without installation:
Local Development
Install the dependencies:
Development
Start the development server with HMR:
Your web viewer will be available at http://localhost:5173.
Building for Production
Create a production build:
Usage
Using npx (Recommended)
Local Development Commands
For development after local installation:
The web viewer will be available at http://localhost:8765 (or your specified port).
MCP Tools
The server provides these tools for Claude Desktop:
add_entry - Add new journal entries
search_entries - Search by date range, tags, or keywords
get_recent_entries - Get most recent entries
list_tags - List all tags with usage counts
get_entry_by_date - Get entries for a specific date
get_daily_summary - Get journal statistics
File Storage
Journal entries are stored in:
Location:
~/.local/share/journal-mcp/entries/YYYY/MM/YYYY-MM-DD.mdFormat: Markdown with YAML frontmatter
Features: Automatic tag extraction, time-based organization
Deployment
Docker Deployment
Manual Deployment
Deploy the output of pnpm build:
Built with ❤️ using React Router and MCP.