Argus Decision MCP
Keep a decision as you worded it, then log what actually happened later
- Pricing
- Open source
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 2.1.0
- Listing updated
- 2 days ago
About Argus Decision MCP
Argus Decision MCP is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.
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.
Install
Run in a terminal
claude mcp add argus-decision-mcp --env ARGUS_TOKEN='<ARGUS_TOKEN>' -- npx -y argus-decision-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"argus-decision-mcp": {
"command": "npx",
"args": [
"-y",
"argus-decision-mcp"
],
"env": {
"ARGUS_TOKEN": "<ARGUS_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"argus-decision-mcp": {
"command": "npx",
"args": [
"-y",
"argus-decision-mcp"
],
"env": {
"ARGUS_TOKEN": "<ARGUS_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"argus-decision-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"argus-decision-mcp"
],
"env": {
"ARGUS_TOKEN": "<ARGUS_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"argus-decision-mcp": {
"command": "npx",
"args": [
"-y",
"argus-decision-mcp"
],
"env": {
"ARGUS_TOKEN": "<ARGUS_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"argus-decision-mcp": {
"command": "npx",
"args": [
"-y",
"argus-decision-mcp"
],
"env": {
"ARGUS_TOKEN": "<ARGUS_TOKEN>"
}
}
}
}Configuration
ARGUS_DIRDirectory for the append-only ledger (.argus). Set once and every tool falls back to it. Claude Code expands ${CLAUDE_PROJECT_DIR}; on other hosts use an absolute path.ARGUS_TOKENOptional Argus account token. Set it and saved records can sync so Argus can return on the date you chose. Unset = fully local, no network.ARGUS_TZTimezone that decides when a check-by date becomes today (e.g. Asia/Seoul). Unset = your machine's local timezone.
What it does
- 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
Pricing
Open source
MIT licence; free local use, optional account sync
Prices change. Check argus.voyage before you buy.
Argus Decision MCP 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 to Argus Decision MCP

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity

Claude Code Ultimate Guide
MCP serverMCP server for searching the Claude Code Ultimate Guide from any MCP client
Runs locally- Open source
- 6.5K GitHub stars
- AI models and LLM tooling

Nautilus Compass Memory
MCP serverLocal-first long-term memory layer for AI agents, served over MCP
Not checked yet- 5 tools
- Remote
- Open source
- 1.3K GitHub stars
- Knowledge and memory

Concord MCP
MCP serverLocal-first MCP server for messaging and shared work-state between coding agents
Runs locally- Freemium
- 1.3K GitHub stars
- Developer tools