SkillFoxx

Edi Life OS MCP

MCP server for the Edi Life OS dashboard: 15 tools for goals, tasks, habits, expenses and notes, driven in plain language.

  • 121 ★ on the repository
  • Last commit
  • MIT
MCP server

Extended access

Why this level

  • Write tools create and delete goals, tasks, notes and expense data in your dashboard.
  • The API token exposes financial records and notes marked as secret.
All reasons and checks

edrisranjbar/lifeosAuthor:edrisranjbar

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/edi-life-os

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • Write tools create and delete goals, tasks, notes and expense data in your dashboard.
  • The API token exposes financial records and notes marked as secret.

This is third-party code. Review the repository files before installing.

What it does

Edi Life OS is a self-hosted dashboard on PHP and MySQL covering habits, goals, a focus timer, kanban, finances and notes. The repository includes the `@edicodes/lifeos-mcp` MCP server, which lets Claude Desktop, Claude Code or another client work with that dashboard. Reading goes through one tool, `lifeos_query`: overview, goals, tasks, habits, finance summary, expenses, incomes, notes. Writes are separate tools: create and edit goals, tasks and notes, mark a habit, log an expense, set income. The server talks only to the token-protected `/api/v1` HTTP API and never touches the database or configs.

Who it is for. Owners of a personal Edi Life OS dashboard who want to run goals and expenses through an assistant instead of clicking through the UI.

Good fit when

  • You want to create a SMART goal and attach a task in one phrase.
  • In the evening you need to tick the day's habits and log a spend.
  • In the morning you want a dashboard summary: goals, tasks, balance.
  • Notes and kanban should be edited from Claude Code without opening a browser.

Not a fit when

  • Edi Life OS is not deployed: the server has nothing to read without it.
  • The client needs a remote MCP URL: the server is stdio only.
  • Finance data must not be shown to a model provider.
  • You need direct database access: the server has no such tools.

Example request

Log a 450,000 Toman food expense and show my balance for the month.

MCP

Transport
stdio
Authentication
API key

Environment variables

LIFEOS_BASE_URL required
URL of your Edi Life OS install: HTTPS, or http://localhost for development.
LIFEOS_API_TOKEN required, secret
The dedicated API token configured on the dashboard server.
LIFEOS_MCP_TIMEOUT_MS
Request timeout in milliseconds, 100 to 120000, default 10000.

Limitations

The dashboard itself must be installed first: Docker Compose, shared hosting or PHP 8.1 with MySQL 8. The MCP server needs Node.js 22.9 or newer and a dedicated API token of at least 32 characters set in `config.php`. Remote origins are accepted only over verified HTTPS, HTTP is allowed for localhost, and redirects are rejected. Version 2.0.0 replaced 12 read tools with a single `lifeos_query`, so clients using old names need a restart. No client config is installed automatically: add it by hand.

How to disable. Remove the `lifeos` entry from the MCP client config. To cut access for good, change or remove `api_token` in the dashboard's `config.php`.

FAQ

How do I connect Edi Life OS to Claude Code?

Add `npx -y @edicodes/lifeos-mcp` to the MCP config and set `LIFEOS_BASE_URL` and `LIFEOS_API_TOKEN`. The token must match the one in `config.php`.

Which tools does the server have?

Fifteen in total: `lifeos_query` for reads, create and update tools for goals, tasks and notes, plus `lifeos_complete_habit`, `lifeos_log_expense` and `lifeos_set_income`.

Can the server see my database?

No. It calls only the `/api/v1` HTTP API with your token, and has no SQL, file or key tools.

Does it work with Codex?

Yes. `mcp/README.md` has an example for `~/.codex/config.toml` with `env_vars` for the token.

How do I run the dashboard itself?

Easiest with Docker: `docker compose up -d` after `cp .env.example .env`. There is also a shared-hosting route and `php -S`.

Discussion

No questions or reviews yet.

MCP servers
Official

An MCP server for workout tracking: Claude Desktop, Cursor and Cline read routines, sets, body weight and 1RM from your self-hosted openGym

MCP serverExtended access21.1K
Official

Doska kanban MCP server: an agent creates cards, moves them across columns, sets deadlines and searches every board

MCP serverExtended access305
Editors’ pick

An MCP server that lets an agent work on your computer: terminal and long-running processes, file search and edits, Excel, PDF and DOCX

MCP serverBroad access10.3K

Connects an agent to Nextcloud: notes, calendar, contacts, files, mail and Deck boards through more than 110 MCP tools

MCP serverBroad access411
Official

An agent writes questions and exams on EduBase, assembles quizzes and analyzes results, using an integration key

MCP serverBroad access28

Installer for Daniel Miessler's personal AI system: memory, hooks, a goals interview and a Pulse dashboard on top of Claude Code, Cursor or Codex

SkillBroad access19.8K

README in short

The project consists of a PHP dashboard, an HTTP API and an optional Node MCP server. It is published in the MCP Registry as `io.github.edrisranjbar/lifeos`, and the README is translated into Spanish and Persian.

README badge

Report a problem