Skip to content
Edi Life OS MCP Server

Edi Life OS MCP Server

by Edris Ranjbar
Added to Onei
MIT
Repository Docs npm
Productivity

Summary

Stdio MCP server that lets Claude read and update a self-hosted Edi Life OS dashboard: goals, tasks, habits, expenses and notes.

Features

  • 15 tools across goals, tasks, habits, finance and notes
  • Single read-only query tool; separate approval-friendly write tools
  • Talks only to the token-protected HTTP API
  • Secret notes hidden by default
  • Published on npm and the MCP Registry

Installation

Set up this MCP server in your favorite AI agent — copy a ready-made configuration below.

Any MCP-compatible agent

Most agents (Claude, Cursor, Windsurf, VS Code, and more) read a standard mcpServers configuration.

  1. Open your agent's MCP configuration file.
  2. Merge the snippet below into it, filling in the environment variables with your own values.
  3. Restart the agent — the "Edi Life OS MCP Server" tools will be available.
{
  "mcpServers": {
    "edi-life-os-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@edicodes/lifeos-mcp"
      ],
      "env": {
        "LIFEOS_BASE_URL": "https://lifeos.example.com",
        "LIFEOS_API_TOKEN": "your-dedicated-token"
      }
    }
  }
}

Description

The Edi Life OS MCP server connects an AI assistant to Edi Life OS, a self-hosted PHP and MySQL dashboard that combines habits, goals, focus timers, Kanban boards, finances and notes. Through 15 tools you can ask Claude to show your dashboard, create a SMART goal with tasks, mark a habit complete, log an expense or write a note in plain language.

Reads go through one read-only lifeos_query tool (dashboard, goals, tasks, habits, finance summary, expenses, incomes, notes), while writes are separate tools so each gets its own approval prompt and destructive deletes are flagged. The server only calls your instance's token-protected /api/v1 HTTP API: it never touches the database or credentials, rejects redirects and URL credentials, requires HTTPS for remote hosts, and omits secret notes unless explicitly permitted.

It runs locally over stdio on Node.js 22.9 or newer and is published on npm as @edicodes/lifeos-mcp and in the official MCP Registry. You need your own Edi Life OS instance (MIT licensed, Docker or shared hosting) and a dedicated API token of at least 32 characters. Finance amounts are in Toman and habit dates default to Tehran time, which matters for non-Iranian users.

Related MCP Servers

MCP: Equibles

by Equibles

Self-hosted financial data MCP server exposing 64 tools over SEC filings, XBRL financials, 13F holdings, insider and congressional trades, FRED and CFTC data.

Databases & Data

MCP: Docs MCP Server

by arabold

Self-hosted documentation retrieval for coding agents — index any library's docs from the web, GitHub, npm, PyPI or local files and query them by exact version. An open-source Context7 alternative.

Developer ToolsWeb & Search
Browse all MCP servers →