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

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:

1. add_entry - Add new journal entries

2. search_entries - Search by date range, tags, or keywords

3. get_recent_entries - Get most recent entries

4. list_tags - List all tags with usage counts

5. get_entry_by_date - Get entries for a specific date

6. get_daily_summary - Get journal statistics

File Storage

Journal entries are stored in:

• Location: ~/.local/share/journal-mcp/entries/YYYY/MM/YYYY-MM-DD.md

• Format: 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.