# Edrisranjbar MCP Server (MCP server)

> Edrisranjbar MCP Server is an MCP server that adds productivity tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Self-hosted life OS: habits, goals, tasks, finances and notes over a token-protected API. It has 121 GitHub stars, is released under the MIT license and runs locally with npx -y @edicodes/lifeos-mcp.

Local stdio server using the official MCP SDK, Node 22.9+ (24 recommended) and Zod validation. All tools call LifeOS /api/v1 over HTTP. No SQL, filesystem, arbitrary state-key, config or credential-management tools are exposed.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/edrisranjbar/lifeos |
| GitHub stars | 121 |
| License | MIT |
| Language | JavaScript |
| Transport | stdio |
| Packages | npm: @edicodes/lifeos-mcp |
| Remote URL | none |
| Needs API key | yes |
| Official | no |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | Productivity |
| Latest release | v1.2.0 (Oct 19, 2026) |
| Last commit | Nov 15, 2026 |
| MCP registry name | io.github.edrisranjbar/lifeos |

## Install

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "edrisranjbar-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@edicodes/lifeos-mcp"
      ],
      "env": {
        "LIFEOS_BASE_URL": "your-value",
        "LIFEOS_API_TOKEN": "your-value"
      }
    }
  }
}
```

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --env LIFEOS_BASE_URL=your-value --env LIFEOS_API_TOKEN=your-value --transport stdio edrisranjbar-mcp-server -- npx -y @edicodes/lifeos-mcp
```

### Cursor (.cursor/mcp.json)

```json
{
  "mcpServers": {
    "edrisranjbar-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@edicodes/lifeos-mcp"
      ],
      "env": {
        "LIFEOS_BASE_URL": "your-value",
        "LIFEOS_API_TOKEN": "your-value"
      }
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

### VS Code (.vscode/mcp.json)

```json
{
  "inputs": [
    {
      "type": "promptString",
      "id": "lifeos_api_token",
      "description": "LIFEOS_API_TOKEN",
      "password": true
    }
  ],
  "servers": {
    "edrisranjbar-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@edicodes/lifeos-mcp"
      ],
      "env": {
        "LIFEOS_BASE_URL": "your-value",
        "LIFEOS_API_TOKEN": "${input:lifeos_api_token}"
      }
    }
  }
}
```

Config formats checked against the official docs on 2026-10-07.

## Environment variables

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

## Similar MCP servers

- [Codex Control Plane MCP](https://appsgit.com/mcp-servers/codex-control-plane-mcp): Durable MCP control plane for long-running Codex Desktop tasks. (121 stars, Apache-2.0)
- [Caldav MCP](https://appsgit.com/mcp-servers/caldav-mcp): CalDAV calendar operations (list, create, update, delete events) as MCP tools. (112 stars, MIT, needs API key)
- [Intervals Icu MCP](https://appsgit.com/mcp-servers/intervals-icu-mcp): Read/write Intervals.icu MCP server: activities, wellness, calendar, gear, and workouts. (124 stars, MIT, needs API key)
- [MCP Gsheets](https://appsgit.com/mcp-servers/mcp-gsheets): MCP server for Google Sheets API — read, write, format, batch operations. (105 stars, MIT, needs API key)
- [Obsidian Hybrid Search](https://appsgit.com/mcp-servers/obsidian-hybrid-search): Search Obsidian vaults with hybrid full-text, fuzzy, semantic, and graph retrieval. (125 stars, MIT)
- [Tendem MCP server](https://appsgit.com/mcp-servers/tendem-mcp-server): Delegate tasks to vetted human experts - research, writing, analysis, and data work. (101 stars, MIT)

---

Canonical page: https://appsgit.com/mcp-servers/edrisranjbar-mcp-server
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed daily.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.
