# Argus Decision MCP

> Argus Decision MCP is an open-source MCP server for productivity. Keep a decision as you worded it, then log what actually happened later. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted
- **Website:** https://argus.voyage
- **Repository:** https://github.com/commet/argus/tree/HEAD/argus-mcp
- **MCP Registry name:** io.github.commet/argus-decision-mcp
- **Categories:** productivity, knowledge and memory
- **Listing updated:** 2026-11-15

## About

Argus works as a ledger for one kind of statement: a prediction you chose to adopt, such as a technical choice with a check-by date. When the date arrives, possibly weeks later in another conversation, it asks what actually happened and appends your answer beside the original wording, which is never edited. The README says nothing is saved until you accept it and that no model verdict or score of the person is produced.

Records are plain local files in an append-only ledger. ARGUS_DIR sets where they live (a home ledger at ~/.argus otherwise), and ARGUS_TZ decides when a check-by date counts as today. With no account or API key it is fully local; an optional ARGUS_TOKEN lets saved records sync so Argus can return on the chosen date.

It needs Node.js 18 or newer, installs with npx -y argus-decision-mcp, and has a Claude Code plugin that adds decision commands. It is MIT licensed and part of the wider Argus web app.

## Features

- **Append-only ledger:** Original wording stays intact; later answers are added next to it.
- **Opt-in saving:** Nothing is recorded unless you accept it.
- **Check-by dates:** Returns to a decision when reality can answer it.
- **Fully local by default:** No network or account unless ARGUS_TOKEN is set.
- **Timezone control:** ARGUS_TZ sets when a date becomes due.

## Good for

- Revisit an architecture choice after a quarter
- Record a hiring or pricing bet and its outcome
- Carry a prediction across separate chat sessions
- Build a personal log of decisions and results

## Install

### Claude Code (Terminal)

```sh
claude mcp add argus-decision-mcp --env ARGUS_TOKEN='<ARGUS_TOKEN>' -- npx -y argus-decision-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "argus-decision-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "argus-decision-mcp"
      ],
      "env": {
        "ARGUS_TOKEN": "<ARGUS_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "argus-decision-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "argus-decision-mcp"
      ],
      "env": {
        "ARGUS_TOKEN": "<ARGUS_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "servers": {
    "argus-decision-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "argus-decision-mcp"
      ],
      "env": {
        "ARGUS_TOKEN": "<ARGUS_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "argus-decision-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "argus-decision-mcp"
      ],
      "env": {
        "ARGUS_TOKEN": "<ARGUS_TOKEN>"
      }
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "argus-decision-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "argus-decision-mcp"
      ],
      "env": {
        "ARGUS_TOKEN": "<ARGUS_TOKEN>"
      }
    }
  }
}
```

## FAQ

### Do I need an account?

No. Records are local files from the first call; an optional token enables sync.

### Does it judge my decisions?

No. The README says it never scores the person or invents a verdict.

### What Node version is needed?

Node.js 18 or newer; 20 LTS is the tested version.

### Where are records stored?

In the directory set by ARGUS_DIR, defaulting to ~/.argus on desktop apps.

### Is Argus Decision MCP free?

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

### How do I add Argus Decision MCP to Claude Code?

Run this command in your terminal: claude mcp add argus-decision-mcp --env ARGUS_TOKEN='<ARGUS_TOKEN>' -- npx -y argus-decision-mcp

### What are the best alternatives to Argus Decision MCP?

The closest alternatives to Argus Decision MCP are Codebase Memory, XERJ, Ha MCP, Claude Code Ultimate Guide and Nautilus Compass Memory.

## Alternatives

- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Nautilus Compass Memory](https://ai-powered.com/mcp/nautilus-compass-memory): Nautilus Compass Memory is an open-source MCP server for knowledge and memory.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.

---
Source: https://ai-powered.com/mcp/argus-decision-mcp
