Skip to content
MCP server

Lifeos

Self-hosted life OS: habits, goals, tasks, finances and notes over a token-protected API.

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
2.0.0
Listing updated
5 days ago

About Lifeos

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

Install

Run in a terminal

claude mcp add lifeos --env LIFEOS_BASE_URL='<LIFEOS_BASE_URL>' --env LIFEOS_API_TOKEN='<LIFEOS_API_TOKEN>' -- npx -y @edicodes/lifeos-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "lifeos": {
      "command": "npx",
      "args": [
        "-y",
        "@edicodes/lifeos-mcp"
      ],
      "env": {
        "LIFEOS_BASE_URL": "<LIFEOS_BASE_URL>",
        "LIFEOS_API_TOKEN": "<LIFEOS_API_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "lifeos": {
      "command": "npx",
      "args": [
        "-y",
        "@edicodes/lifeos-mcp"
      ],
      "env": {
        "LIFEOS_BASE_URL": "<LIFEOS_BASE_URL>",
        "LIFEOS_API_TOKEN": "<LIFEOS_API_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "lifeos": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@edicodes/lifeos-mcp"
      ],
      "env": {
        "LIFEOS_BASE_URL": "<LIFEOS_BASE_URL>",
        "LIFEOS_API_TOKEN": "<LIFEOS_API_TOKEN>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "lifeos": {
      "command": "npx",
      "args": [
        "-y",
        "@edicodes/lifeos-mcp"
      ],
      "env": {
        "LIFEOS_BASE_URL": "<LIFEOS_BASE_URL>",
        "LIFEOS_API_TOKEN": "<LIFEOS_API_TOKEN>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "lifeos": {
      "command": "npx",
      "args": [
        "-y",
        "@edicodes/lifeos-mcp"
      ],
      "env": {
        "LIFEOS_BASE_URL": "<LIFEOS_BASE_URL>",
        "LIFEOS_API_TOKEN": "<LIFEOS_API_TOKEN>"
      }
    }
  }
}

Configuration

  • LIFEOS_BASE_URLURL of your Edi Life OS install (HTTPS, or http://localhost for development)Required
  • LIFEOS_API_TOKENThe dedicated API token configured on your Edi Life OS serverRequired
  • LIFEOS_MCP_TIMEOUT_MSRequest timeout in milliseconds (100-120000, default 10000)

Pricing

Open source

Lifeos FAQ

Is Lifeos free?

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

How do I add Lifeos to Claude Code?

Run this command in your terminal: claude mcp add lifeos --env LIFEOS_BASE_URL='<LIFEOS_BASE_URL>' --env LIFEOS_API_TOKEN='<LIFEOS_API_TOKEN>' -- npx -y @edicodes/lifeos-mcp