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
# Changelog
All notable changes to this project will be documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
## [Unreleased]
## [1.0.1] - 2026-02-02
### Changed
- Upgrade Jest 29.7.0 → 30.2.0
- Upgrade ESLint 8.x → 9.39.2 with Flat Config migration
- Upgrade TypeScript 5.2.2 → 5.9.3
- Upgrade MCP SDK 1.13.2 → 1.25.3
- Remove unused date-fns dependency
### Added
- Custom error classes for better error handling (`JrnlNotFoundError`, `JrnlExecutionError`, etc.)
- Enhanced logger utilities with debug mode support
- Architecture documentation with Mermaid diagrams (`docs/ARCHITECTURE.md`)
- Architecture Decision Records (`docs/ARCHITECTURE_DECISIONS.md`)
- Test fixtures and mock data helpers
- Glama MCP server badge in README
### Improved
- Error handling across all handlers and utilities
- Type safety: eliminated all `any` types from source code
- Test coverage: 26 → 50 tests
- CI testing with mock mode for environment independence
### Security
- Resolved 9 dependency vulnerabilities (now 0)
## [1.0.0] - 2025-07-08
### Added
- Initial release of jrnl MCP server
- Complete implementation of Model Context Protocol for jrnl CLI
- Six main tools for journal interaction:
- `search_entries` - Search and filter journal entries with date/tag/text criteria
- `list_tags` - Get all tags with usage counts
- `analyze_tag_cooccurrence` - Analyze which tags appear together
- `get_statistics` - Get analytics (word counts, temporal grouping, top tags)
- `list_journals` - List available journals
- `set_journal` - Switch active journal
- TypeScript implementation with comprehensive type definitions
- Full test coverage with unit and integration tests
- Claude Desktop integration support
- Global installation via npm link
- Read-only safety guarantees with input validation
- Support for jrnl's natural language date parsing
- JSON export format for structured data
- Development tooling configuration (ESLint, Prettier, Jest)
- Documentation including README.md and CLAUDE.md
### Security
- Read-only access enforcement - no write operations allowed
- Input validation to prevent command injection
- No exposure of file paths or system information
[Unreleased]: https://github.com/yostos/jrnl-mcp/compare/v1.0.1...HEAD
[1.0.1]: https://github.com/yostos/jrnl-mcp/compare/v1.0.0...v1.0.1
[1.0.0]: https://github.com/yostos/jrnl-mcp/releases/tag/v1.0.0