AIBase
EN
Explore
Journal MCP
J

Journal MCP

A diary management server based on the MCP protocol, providing Claude desktop integration and a React Web viewer, supporting the storage, search, and browsing functions of Markdown-format diaries.
Knowledge management and memoryNote-taking tools#Diary management#MCP protocol#React viewer#File storage.TypeScript
2 points
0
Open Site

Content Details

Alternatives

Installation

Copy the following command to your Client for configuration
Note: Your key is sensitive information, do not share it with anyone.

๐Ÿš€ Journal MCP Server

A Model Context Protocol (MCP) server for journal entries with a React Router v7 web viewer.

โœจ Features

  • ๐Ÿ“– MCP Server: Integrate with Claude Desktop for efficient journal management.
  • ๐ŸŒ Web Viewer: A React-based interface for easy browsing of journal entries.
  • ๐Ÿš€ Server-side rendering powered by React Router.
  • โšก๏ธ Hot Module Replacement (HMR) to speed up the development process.
  • ๐Ÿ”’ TypeScript is used by default for enhanced type safety.
  • ๐ŸŽ‰ TailwindCSS for stylish and responsive UI design.
  • ๐Ÿ“ File-based storage with automatic organization of journal entries.

๐Ÿš€ Quick Start

Quick Start with npx

You can run the application directly without installation:

# Start web viewer
npx @coji/journal-mcp --viewer

# Setup Claude Desktop integration
npx @coji/journal-mcp --setup

# Start MCP server for Claude Desktop
npx @coji/journal-mcp

Local Development

First, install the dependencies:

pnpm install

Development

Start the development server with HMR enabled:

pnpm dev

You can access the web viewer at http://localhost:5173.

Building for Production

Create a production build using the following command:

pnpm build

๐Ÿ’ป Usage Examples

Using npx (Recommended)

# Show help
npx @coji/journal-mcp --help

# Setup Claude Desktop integration
npx @coji/journal-mcp --setup

# Verify Claude Desktop setup
npx @coji/journal-mcp --verify-setup

# Start MCP server for Claude Desktop
npx @coji/journal-mcp

# Start web viewer
npx @coji/journal-mcp --viewer

# Custom port examples
npx @coji/journal-mcp --viewer --port 8080

Local Development Commands

After local installation, use the following commands for development:

# Show help
node dist/index.js --help

# Setup Claude Desktop configuration
node dist/index.js --setup

# Start MCP server
node dist/index.js

# Start web viewer
node dist/index.js --viewer

The web viewer will be available at http://localhost:8765 (or the port you specified).

๐Ÿ“š Documentation

MCP Tools

The server offers the following tools for Claude Desktop:

  1. add_entry: Add new journal entries.
  2. search_entries: Search for entries by date range, tags, or keywords.
  3. get_recent_entries: Retrieve the most recent entries.
  4. list_tags: List all tags along with their usage counts.
  5. get_entry_by_date: Get entries for a specific date.
  6. get_daily_summary: Obtain journal statistics.

File Storage

Journal entries are stored in the following manner:

  • Location: ~/.local/share/journal-mcp/entries/YYYY/MM/YYYY-MM-DD.md
  • Format: Markdown with YAML frontmatter
  • Features: Automatic tag extraction and time-based organization

Deployment

Docker Deployment

docker build -t journal-mcp .
docker run -p 8765:8765 journal-mcp

Manual Deployment

Deploy the output of pnpm build:

โ”œโ”€โ”€ package.json
โ”œโ”€โ”€ pnpm-lock.yaml
โ”œโ”€โ”€ build/
โ”‚   โ”œโ”€โ”€ client/    # Static assets
โ”‚   โ””โ”€โ”€ server/    # Server-side code

Built with โค๏ธ using React Router and MCP.

Alternatives

C
Cipher
Cipher is an open-source memory layer framework designed for programming AI agents. It integrates with various IDEs and AI coding assistants through the MCP protocol, providing core functions such as automatic memory generation, team memory sharing, and dual-system memory management.
TypeScript
0
5 points
A
Apple Notes MCP
A server that provides local Apple Notes database access for the Claude desktop client, supporting reading and searching of note content.
Python
12.6K
4.3 points
M
MCP Server Weread
The WeRead MCP Server is a lightweight service that bridges WeRead data and AI clients, enabling in - depth interaction between reading notes and AI.
TypeScript
13.2K
4 points
M
MCP Notion Server
Certified
The Notion MCP Server is a middleware service that connects the Notion API with the LLM, optimizing interaction efficiency through Markdown conversion.
TypeScript
14.0K
5 points
M
MCP Obsidian
This project is an MCP server used to interact with the Obsidian note application through the Local REST API plugin of Obsidian. It provides various tools to operate and manage files in Obsidian, including listing files, retrieving file content, searching, modifying content, and deleting files.
Python
12.9K
5 points
M
MCP Atlassian
MCP Atlassian is a Model Context Protocol server designed for Atlassian products (Confluence and Jira), supporting both cloud and on-premises deployments and providing AI assistant integration functions.
Python
13.2K
5 points
M
MCP Logseq Server
An MCP server for interacting with the LogSeq note-taking app, providing various API tools to operate on note content.
Python
16.0K
4.1 points
S
Solana Docs MCP Server
A TypeScript-based MCP server that implements a simple note system and supports note creation and summarization functions
TypeScript
12.3K
4.2 points
N
Notion Api MCP
Certified
A Python-based MCP Server that provides advanced to-do list management and content organization functions through the Notion API, enabling seamless integration between AI models and Notion.
Python
15.8K
4.5 points
M
Markdownify MCP
Markdownify is a multi-functional file conversion service that supports converting multiple formats such as PDFs, images, audio, and web page content into Markdown format.
TypeScript
23.8K
5 points
G
Gitlab MCP Server
Certified
The GitLab MCP server is a project based on the Model Context Protocol that provides a comprehensive toolset for interacting with GitLab accounts, including code review, merge request management, CI/CD configuration, and other functions.
TypeScript
15.7K
4.3 points
D
Duckduckgo MCP Server
Certified
The DuckDuckGo Search MCP Server provides web search and content scraping services for LLMs such as Claude.
Python
45.0K
4.3 points
F
Figma Context MCP
Framelink Figma MCP Server is a server that provides access to Figma design data for AI programming tools (such as Cursor). By simplifying the Figma API response, it helps AI more accurately achieve one - click conversion from design to code.
TypeScript
46.0K
4.5 points
U
Unity
Certified
UnityMCP is a Unity editor plugin that implements the Model Context Protocol (MCP), providing seamless integration between Unity and AI assistants, including real - time state monitoring, remote command execution, and log functions.
C#
19.3K
5 points
G
Gmail MCP Server
A Gmail automatic authentication MCP server designed for Claude Desktop, supporting Gmail management through natural language interaction, including complete functions such as sending emails, label management, and batch operations.
TypeScript
15.0K
4.5 points
M
Minimax MCP Server
The MiniMax Model Context Protocol (MCP) is an official server that supports interaction with powerful text-to-speech, video/image generation APIs, and is suitable for various client tools such as Claude Desktop and Cursor.
Python
29.5K
4.8 points