# Devlog

> Devlog is an open-source MCP server for productivity. Offline terminal developer journal with local-LLM digests and an MCP server. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Linux, Windows, Self-hosted
- **Repository:** https://github.com/spiob/devlog-cli
- **MCP Registry name:** io.github.SpIob/devlog
- **Categories:** [productivity](https://ai-powered.com/categories/productivity)
- **Listing updated:** 2026-11-19

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add devlog -- uvx devlog-tool
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## 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.

## Alternatives

- [Worklog](https://ai-powered.com/mcp/worklog): Worklog is an open-source MCP server for productivity.
- [SoloMD](https://ai-powered.com/mcp/solomd): SoloMD is an open-source MCP server for knowledge and memory.
- [Dayfile.app](https://ai-powered.com/mcp/dayfile-app): Dayfile.app is an open-source MCP server for productivity.
- [agentmailkit](https://ai-powered.com/mcp/agentmailkit): agentmailkit is an open-source MCP server for productivity.
- [Changologs MCP](https://ai-powered.com/mcp/changologs-mcp): Changologs MCP is an MCP server for productivity.
- [Todo MCP](https://ai-powered.com/mcp/todo-mcp-2): Todo MCP is an open-source MCP server for productivity.
- [md-doc](https://ai-powered.com/mcp/md-doc): md-doc is a free MCP server for knowledge and memory.
- [mindin](https://ai-powered.com/mcp/mindin): mindin is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/devlog
