Livejournal
About
Local MCP server for LiveJournal journals. It uses the legacy LiveJournal XML-RPC API to read entries, read comments, post to your own journal, and build a local SQLite cache for search.
Details
- Author
- pavelber
- Downloads
- 284
- Categories
- Developer Tools
Jump to
- Read recent, dated, or specific entries by itemid.
- Create posts with a default dry run (dry_run: true).
- Search recently fetched or locally cached entries.
- Fetch and cache entry comments via LiveJournal XMLRPC.
- Generate an ljsession for authenticated web endpoint access.
- Cache entries in SQLite and query the cache.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
LivejournalCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
You need Python 3.10+, a LiveJournal account, and an MCP‑compatible client. SQLite (built into Python) is used for local caching. The server exposes tools for reading, searching, creating, and caching entries. Invoke it as an MCP server; no explicit install or configuration steps are provided in the README beyond the requirements.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"livejournal": {
"livejournal": {
"command": "C:\\path\\to\\livejournal-mcp\\.venv\\Scripts\\python.exe",
"args": [
"-m",
"livejournal_mcp.server"
],
"env": {
"LJ_USERNAME": "your_livejournal_username",
"LJ_PASSWORD": "your_livejournal_password",
"LJ_JOURNAL": "your_livejournal_username",
"LJ_CACHE_PATH": "C:\\Users\\you\\AppData\\Local\\livejournal-mcp\\livejournal.sqlite3"
}
}
}
}
}McpServers
{
"livejournal": {
"command": "C:\\path\\to\\livejournal-mcp\\.venv\\Scripts\\python.exe",
"args": [
"-m",
"livejournal_mcp.server"
],
"env": {
"LJ_USERNAME": "your_livejournal_username",
"LJ_PASSWORD": "your_livejournal_password",
"LJ_JOURNAL": "your_livejournal_username",
"LJ_CACHE_PATH": "C:\\Users\\you\\AppData\\Local\\livejournal-mcp\\livejournal.sqlite3"
}
}
}Features
- Read recent entries.
- Read one entry by itemid.
- Read entries for a specific date.
- Search recently fetched entries.
- Read entry comments with LJ.XMLRPC.getcomments.
- Create posts, with dry_run: true by default.
- Generate an ljsession for authenticated LiveJournal web endpoints.
- Cache entries in SQLite and search cached entries locally.
Tools
- check_login
- list_entries
- get_entries_for_date
- search_recent_entries
- get_entry
- sync_entries
- get_entry_comments
- create_post
- generate_session
- cache_recent_entries
- cache_entries_for_date
- cache_synced_entries
- cache_entry
- search_cached_entries
- list_cached_entries
- get_cached_entry
- cache_stats
- clear_cache
Requirements
- Python 3.10+
- A LiveJournal account
- An MCP-compatible client
- SQLite is built into Python. No separate SQLite installation is required.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
