Skip to content
Agents tracked: 442 Downloads (7d): 202M down 19.3% GitHub stars: 10.4M Releases (7d): 693 Agent status: 1 with issuesSince last limit reset: Claude 28d · Codex 1d Updated Oct 21, 2026
Showcase

Run a self-hosted life dashboard that Claude can control through an MCP server

Edris Ranjbar's open-source Edi Life OS combines habits, goals, Kanban, finance, focus timers and notes in one self-hosted PHP and MySQL dashboard. An optional MCP server lets Claude and other MCP clients read and update the dashboard in plain language.

The problem

Personal productivity often spreads across a to-do app, habit tracker, budgeting spreadsheet, Pomodoro timer and notes app, and none of them share data. The project aims to bring these into one private dashboard that an AI assistant can also operate.

How they did it

  1. Deploy the app with Docker Compose, on shared hosting, or locally with PHP 8.1+ and MySQL 8+.
  2. Generate a random token and set it as api_token in config.php or as the LIFEOS_API_TOKEN environment variable.
  3. Go to the mcp folder, run npm ci, and copy .env.example to .env with LIFEOS_BASE_URL and LIFEOS_API_TOKEN set.
  4. Start the MCP server with npm start; it runs over stdio, and there is no hosted MCP endpoint.
  5. Connect Claude Desktop, Claude Code or another MCP client following the MCP guide.
  6. Ask the assistant to show the dashboard, create goals and tasks, mark habits complete or log expenses.

From the official docs

cd mcp
npm ci
cp .env.example .env # set LIFEOS_BASE_URL and LIFEOS_API_TOKEN
npm start

Results

  • The MCP server exposes 15 tools covering the dashboard, goals, tasks, habits, finances and notes.
  • The README shows an expense logged by Claude appearing in the Finance workspace through the real API, using sample data.
  • The MCP server reaches the app only through its token-protected HTTP API and never touches the database or credentials.
  • Limits noted by the author: one operator token for a single account, and no per-user tokens, scopes or rate limiting.

As reported by the source (GitHub repository README (edrisranjbar/lifeos)); AgentGid did not measure these figures.

Takeaway. Putting an existing app behind a token-protected HTTP API and a small stdio MCP server lets an AI assistant operate it without direct database access.
AgentGid's take

Suits a solo user comfortable with Docker or PHP/MySQL hosting and a Node install, since you run the app and the stdio MCP server yourself. Watch the single operator token: no per-user scopes or rate limiting, so keep it private and the app off the open internet. The README demo uses sample data. Claude Code needs a paid plan ($20/mo); Pi (Free, OSS) is a cheaper terminal alternative, though you pay for its model provider.

The agent used here

Similar use cases

Guides