Skip to main content
Glama

jrnl MCP Server

by yostos
npmGitHub
TypeScript
MIT License
7
  • Apple
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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

npm install npm run build npm link # Install globally as jrnl-mcp command

Claude Desktop Configuration

Add the following to your Claude Desktop configuration file:

macOS

Location: ~/Library/Application Support/Claude/claude_desktop_config.json

Configuration

{ "mcpServers": { "jrnl": { "command": "jrnl-mcp" } } }

Note: If you installed via npm link, the command will be globally available. For local development without global installation, use:

{ "mcpServers": { "jrnl": { "command": "node", "args": ["<path-to-project>/dist/index.js"] } } }

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

npm run format # Format code npm run lint # Run linter npm test # Run tests npm run build # Build for production

Testing with Claude Desktop

  1. Build the project: npm run build
  2. Update your Claude Desktop config with the correct path
  3. Restart Claude Desktop
  4. 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"
Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Tools

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.

  1. Prerequisites
    1. Installation
      1. Claude Desktop Configuration
        1. macOS
        2. Configuration
      2. Available Tools
        1. Development
          1. Testing with Claude Desktop

            Related MCP Servers

            • Code Analysis MCP Server

              saiprashanths
              A
              security
              F
              license
              A
              quality
              The 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 -
              4
              16
              Python
              • Apple

            • Gmail MCP

              vinayak-mehta
              -
              security
              A
              license
              -
              quality
              A 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 -
              4
              Python
              Apache 2.0

            • Needle MCP Serverofficial

              needle-ai
              A
              security
              A
              license
              A
              quality
              A server that allows users to manage documents and perform Claude-powered searches using Needle through the Claude Desktop application.
              Last updated -
              7
              70
              Python
              MIT License
              • Apple

            • MCP Web Research Server

              jevy
              A
              security
              A
              license
              A
              quality
              A 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 -
              3
              821
              MIT License
              • Apple

            View all related MCP servers

            New MCP Servers

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/yostos/jrnl-mcp'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server