Skip to content
MCP server

Devlog

Offline terminal developer journal with local-LLM digests and an MCP server

Runs locally
Install

Devlog is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.

Pricing
Open source
Platforms
CLI, macOS, Linux
Runs
Locally
Version
2.0.1
Listing updated

Similar MCP servers

Install

Run in a terminal

claude mcp add devlog -- uvx devlog-tool

Add to claude_desktop_config.json

{
  "mcpServers": {
    "devlog": {
      "command": "uvx",
      "args": [
        "devlog-tool"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "devlog": {
      "command": "uvx",
      "args": [
        "devlog-tool"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "devlog": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "devlog-tool"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "devlog": {
      "command": "uvx",
      "args": [
        "devlog-tool"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "devlog": {
      "command": "uvx",
      "args": [
        "devlog-tool"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • DEVLOG_BACKENDStorage backend: json (default) or sqlite
  • DEVLOG_DATA_DIRCustom data directory for the journal
  • DEVLOG_TZIANA timezone for local date bucketing (e.g., America/New_York)
  • DEVLOG_OLLAMA_HOSTOllama server URL for AI features (default: http://127.0.0.1:11434)
  • DEVLOG_EMBED_MODELEmbedding model for semantic search (default: nomic-embed-text)
  • DEVLOG_AIEnable LLM summaries by default (set to '1')

About Devlog

The README describes devlog as a command-line journal for logging daily development progress, with entries that can be tagged, searched, filtered and exported as Markdown or JSON. Entries are stored locally, and the project positions itself as working fully offline.

AI features are optional. Weekly digests are built without a model by grouping entries by day with tags and totals; passing a flag hands that text to a local Ollama server for a written summary. Semantic search and the ask command rely on Ollama embedding and chat models. The package also includes an MCP server so AI agents can read the journal.

It suits developers who want a private, scriptable work log that lives in a terminal or a git repository, and who are willing to run Ollama if they want the LLM-backed features.

What it does

Tagged journal entries
Add entries with lowercase tags, then list, search, and filter them by tag and date range.
Offline weekly digests
Produces a day-grouped weekly summary with tag totals without requiring a model or network access.
Local LLM features
Uses a local Ollama server for optional written summaries and semantic search.
Git-linked entries
Creates journal entries from commits, taking the message, scope tags and author date from git.
Import and export
Imports jrnl and Day One JSON exports and exports the journal to Markdown or JSON.
Backups and undo
Writes timestamped backups and snapshots before each write so the last change can be undone.

Good for

  • Keep a daily log of development work in the terminal
  • Search past work by keyword or tag before a standup or review
  • Generate an offline weekly summary of what was shipped
  • Let an AI agent query a local developer journal through MCP
  • Move an existing jrnl or Day One history into a plain-text store

Pricing

Open source

Free and self-hosted; the README does not mention a paid plan.

Devlog FAQ

Does Devlog need an internet connection?

The README says the journal and the default digest work fully offline. The LLM features need a local Ollama server.

Which Python version is required?

The README states Python 3.10 or newer.

How is Devlog installed?

With pipx or pip using the devlog-tool package, or directly from the GitHub repository.

Where is the data stored?

By default in ~/.devlog, or in the directory set by DEVLOG_DATA_DIR. The README does not describe any cloud sync.

Is Devlog free?

Yes. Devlog is open source, so you can use and self-host it for free.

How do I add Devlog to Claude Code?

Run this command in your terminal: claude mcp add devlog -- uvx devlog-tool

What are the best alternatives to Devlog?

The closest alternatives to Devlog are Worklog, SoloMD, Dayfile.app, agentmailkit and Changologs MCP.

Where this comes from

  • Description: written from the project's README and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers