jrnl MCP Server
A Model Context Protocol (MCP) server that provides read-only access to jrnl (command-line journal) entries.
Prerequisites
- Node.js 18 or higher
- jrnl installed and configured (
pip install jrnl
)
Installation
Claude Desktop Configuration
Add the following to your Claude Desktop configuration file:
macOS
Location: ~/Library/Application Support/Claude/claude_desktop_config.json
Configuration
Note: If you installed via npm link
, the command will be globally available.
For local development without global installation, use:
Available Tools
- search_entries - Search journal entries with filters
- list_tags - List all tags with usage counts
- get_statistics - Get journal statistics
- analyze_tag_cooccurrence - Analyze tag co-occurrences
- list_journals - List available journals
- set_journal - Switch to a different journal
Development
Testing with Claude Desktop
- Build the project:
npm run build
- Update your Claude Desktop config with the correct path
- Restart Claude Desktop
- Test by asking Claude to search your journal entries
Example prompts:
- "Use jrnl to show me my journal entries from last week"
- "Using jrnl, what tags am I using in my journal?"
- "Can you use jrnl to show me statistics about my journal?"
- "Search my journal entries for entries tagged with @work using jrnl"
local-only server
The server can only run on the client's local machine because it depends on local resources.
A server that enables Claude to access and search through command-line journal entries, offering features like searching entries, listing tags, and viewing journal statistics.
Related MCP Servers
- AsecurityFlicenseAqualityThe server facilitates natural language interactions for exploring and understanding codebases, providing insights into data models and system architecture using a cost-effective, simple setup with support for existing Claude Pro subscriptions.Last updated -416Python
- -securityAlicense-qualityA server that allows Claude to search and retrieve emails from your Gmail account, supporting functions like searching emails, retrieving full content of specific emails, and listing recent messages.Last updated -4PythonApache 2.0
Needle MCP Serverofficial
AsecurityAlicenseAqualityA server that allows users to manage documents and perform Claude-powered searches using Needle through the Claude Desktop application.Last updated -770PythonMIT License- AsecurityAlicenseAqualityA server that integrates with Claude Desktop to enable real-time web research capabilities, allowing users to search Google, extract webpage content, and capture screenshots directly from conversations.Last updated -3821MIT License