# lifeos

Connects your coding assistant to a self-hosted LifeOS instance to track habits, goals, tasks, expenses, and notes via API.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 80
- Author: edrisranjbar
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/edrisranjbar/lifeos/tree/HEAD/mcp
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/lifeos

## What it does

The server runs over stdio on Node 22.9+ and communicates with a self-hosted LifeOS backend via `/api/v1` HTTP requests. All data retrieval goes through a unified `lifeos_query` tool, which fetches dashboard metrics, habit logs, task boards, or balance summaries. Mutating actions, including creating goals or updating tasks, use dedicated tool calls with explicit approval points.

Security controls disallow plain HTTP for remote hosts; only local loopback addresses may use unencrypted traffic. Without a configured PHP backend and a token of at least 32 characters, initialization fails immediately. Confidential notes stay hidden unless explicitly requested with appropriate permissions.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `LIFEOS_BASE_URL`, `LIFEOS_API_TOKEN`, `LIFEOS_MCP_TIMEOUT_MS` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env LIFEOS_BASE_URL=<LIFEOS_BASE_URL> --env LIFEOS_API_TOKEN=<LIFEOS_API_TOKEN> --env LIFEOS_MCP_TIMEOUT_MS=<LIFEOS_MCP_TIMEOUT_MS> --transport stdio mcp -- npx -y @edicodes/lifeos-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add mcp --env LIFEOS_BASE_URL=<LIFEOS_BASE_URL> --env LIFEOS_API_TOKEN=<LIFEOS_API_TOKEN> --env LIFEOS_MCP_TIMEOUT_MS=<LIFEOS_MCP_TIMEOUT_MS> -- npx -y @edicodes/lifeos-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@edicodes/lifeos-mcp"
            ],
            "env": {
                "LIFEOS_BASE_URL": "<LIFEOS_BASE_URL>",
                "LIFEOS_API_TOKEN": "<LIFEOS_API_TOKEN>",
                "LIFEOS_MCP_TIMEOUT_MS": "<LIFEOS_MCP_TIMEOUT_MS>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@edicodes/lifeos-mcp"
            ],
            "env": {
                "LIFEOS_BASE_URL": "<LIFEOS_BASE_URL>",
                "LIFEOS_API_TOKEN": "<LIFEOS_API_TOKEN>",
                "LIFEOS_MCP_TIMEOUT_MS": "<LIFEOS_MCP_TIMEOUT_MS>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e LIFEOS_BASE_URL=<LIFEOS_BASE_URL> -e LIFEOS_API_TOKEN=<LIFEOS_API_TOKEN> -e LIFEOS_MCP_TIMEOUT_MS=<LIFEOS_MCP_TIMEOUT_MS> mcp npx -y @edicodes/lifeos-mcp
```
Replace <…> with your own values

## When to use it
- fetch LifeOS dashboard summaries and active tasks
- track daily habit completion
- create structured goals with milestone action items
- log expenses in Toman and inspect current finances

## Example prompts
- Show my LifeOS dashboard summary
- Mark my reading habit as completed for today
- Log an expense of 450000 Toman for groceries

## Similar
- [Reactive Resume](https://affpapa.org/en/nevibecode/mcp/reactive-resume.md) — MCP server · ★ 44874
- [screenpipe](https://affpapa.org/en/nevibecode/mcp/screenpipe.md) — MCP server · ★ 22053
- [Inbox Zero](https://affpapa.org/en/nevibecode/mcp/inbox-zero.md) — MCP server · ★ 12791
- [kaneo](https://affpapa.org/en/nevibecode/mcp/kaneo.md) — MCP server · ★ 9602
- [Mindwtr](https://affpapa.org/en/nevibecode/mcp/mindwtr.md) — MCP server · ★ 2318
- [Azure DevOps (ADO)](https://affpapa.org/en/nevibecode/mcp/azure-devops-ado.md) — MCP server · ★ 2067

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md