
Journald MCP Server
Gives Claude direct access to systemd journal logs for incident response and forensic analysis. Exposes tools to query journal entries with natural language datetime filtering (like "2 hours ago" or "yesterday at 3pm"), filter by systemd unit or syslog identifier, and search message content. Also provides resources to list all units and identifiers across time ranges, plus fetch the first entry datetime. Built on systemd-python and supports stdio, SSE, or HTTP transports. Reach for this when you need to troubleshoot Linux systems, correlate service failures, or hunt through logs without leaving your Claude conversation. Requires systemd-journal group access to run as non-root.
- GitHub stars
- 1
- tools
- 2
- transport
- STDIO
- last updated
- Dec 19, 2025
Tools
2 toolsPublic tool metadata for what this MCP can expose to an agent.
get_journal_entriesGet journal entries with datetime filtering
Get journal entries with datetime filtering
No parameter schema in public metadata yet.
get_recent_logsGet recent journal logs from the last N minutes
Get recent journal logs from the last N minutes
No parameter schema in public metadata yet.
Sponsors
Readme
Journald MCP Server
An MCP server for accessing systemd journal logs.
Features
- List systemd units from journal logs
- List syslog identifiers from journal logs
- Get datetime of first journal entry
- Filter journal entries by datetime range (since/until)
- Filter by systemd unit or syslog identifier
- Filter by message content (case-insensitive substring matching)
- Natural language datetime parsing (e.g., "2 hours ago", "yesterday at 3pm")
- List units and identifiers within specific time ranges
Installation
# Install dependencies
uv sync
Usage
Run as non-root: Give the user systemd-journal group access usermod -aG systemd-journal $USER
Run the server with:
uv run server.py [OPTIONS]
CLI Options
--transport: Transport protocol to use (stdio,sse, orstreamable-http). Default:stdio--port: Port to listen on for HTTP transport (ignored forstdiotransport). Default:3002--log-level: Logging level (DEBUG,INFO,WARNING,ERROR,CRITICAL). Default:INFO
Examples
Details
- Repository
- github.com/james116blue/journald-mcp-server
- Category
- Monitoring & Observability
- Package
journald-mcp-server- Transport
- STDIO
- Registry
- MCP registry, active