Skip to main content
Glama
deenesjakoruzh
bwats

lifeos-mcp

by bwats
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Local

LifeOS MCP

Gib jedem KI-Agenten Lesezugriff auf deine LifeOS-Wissensdatenbank — Claude Desktop, Claude Code, Cursor, ChatGPT, Codex oder jeden anderen MCP-kompatiblen Client.

Der Server liest aus ~/lifeos/ und stellt alles über lifeos:// Ressourcen-URIs und lifeos__* Tool-Namen bereit.

Installation

Nach der Veröffentlichung (bald verfügbar)

npx lifeos-mcp

Aus dem Quellcode (jetzt)

git clone https://github.com/bwats/lifeos-mcp
cd lifeos-mcp
npm install && npm run build
node bin/lifeos-mcp.js

Globale Installation aus dem Quellcode

cd ~/lifeos-mcp
npm install -g .
lifeos-mcp  # starts the MCP server on stdio

Was wird bereitgestellt

lifeos-mcp gibt jedem MCP-kompatiblen KI-Client direkten Lesezugriff auf:

Oberfläche

Pfad in ~/lifeos/

Tool

Identität

identity.md

lifeos__get_identity

Präferenzen

preferences.md

lifeos__get_preferences

Fähigkeiten

skills/*/

lifeos__list_skills, lifeos__read_skill

Projekte

projects/*.md

lifeos__list_projects, lifeos__read_project

Wiki

wiki/pages/**/*.md

lifeos__list_wiki_pages, lifeos__read_wiki_page

Regeln

system/*.md

lifeos__list_rules, lifeos__read_rule

Beliebige Datei

(pfadsicher)

lifeos__read_file

Suche

(Volltext)

lifeos__search

Modi

Aufruf

Was passiert

lifeos-mcp

Startet MCP-Server auf stdio (Standard)

lifeos-mcp --stdio

Startet MCP-Server auf stdio (explizit)

lifeos-mcp list

Listet Rituale in ~/lifeos/cadence/rituals/ auf

lifeos-mcp validate <ritual.md>

Validiert eine Ritual-Spezifikationsdatei

lifeos-mcp render <ritual.md> --to <harness>

Rendert Ritual für ein Ziel-Harness

lifeos-mcp --help

Zeigt alle Unterbefehle und Optionen an

MCP-Clients konfigurieren

Claude Desktop

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "lifeos": {
      "command": "npx",
      "args": ["lifeos-mcp"]
    }
  }
}

Oder aus dem Quellcode:

{
  "mcpServers": {
    "lifeos": {
      "command": "node",
      "args": ["/Users/yourname/lifeos-mcp/bin/lifeos-mcp.js"]
    }
  }
}

Cursor (settings.json)

{
  "mcpServers": {
    "lifeos": {
      "command": "node",
      "args": ["/Users/yourname/lifeos-mcp/bin/lifeos-mcp.js"]
    }
  }
}

Claude Code (~/.claude/settings.json)

{
  "mcpServers": {
    "lifeos": {
      "command": "node",
      "args": ["/Users/yourname/lifeos-mcp/bin/lifeos-mcp.js"]
    }
  }
}

OpenAI Codex (codex.json)

{
  "mcpServers": {
    "lifeos": {
      "command": "node",
      "args": ["/Users/yourname/lifeos-mcp/bin/lifeos-mcp.js"]
    }
  }
}

Benutzerdefinierter LifeOS-Pfad

Übergebe --lifeos-path oder setze die Umgebungsvariable LIFEOS_PATH:

{
  "mcpServers": {
    "lifeos": {
      "command": "node",
      "args": [
        "/Users/yourname/lifeos-mcp/bin/lifeos-mcp.js",
        "--lifeos-path", "/custom/path/to/lifeos"
      ]
    }
  }
}

Umgebungsvariablen

Variable

Standard

Beschreibung

LIFEOS_PATH

~/lifeos

Absoluter Pfad zum LifeOS-Stammverzeichnis

Tools

Tool

Beschreibung

lifeos__health

Überprüft den Serverstatus und die LifeOS-Verfügbarkeit

lifeos__get_identity

Liest identity.md — Frontmatter + Inhalt

lifeos__get_preferences

Liest preferences.md — Frontmatter + Inhalt

lifeos__list_skills

Listet alle Fähigkeits-Verzeichnisnamen in ~/lifeos/skills/ auf

lifeos__read_skill

Liest die Dokumentation für eine benannte Fähigkeit

lifeos__list_rules

Listet Regel-/Richtliniennamen aus ~/lifeos/system/ auf

lifeos__read_rule

Liest eine spezifische Regeldatei

lifeos__list_projects

Listet Projektdateinamen aus ~/lifeos/projects/ auf

lifeos__read_project

Liest eine spezifische Projektdefinition

lifeos__list_wiki_pages

Listet alle Wiki-Seitenpfade rekursiv auf

lifeos__read_wiki_page

Liest eine Wiki-Seite nach Pfad

lifeos__search

Volltextsuche über alle LifeOS-Dateien

lifeos__read_file

Liest jede Datei unter ~/lifeos/ nach relativem Pfad (pfad-traversal-sicher)

lifeos__propose_edge

Schlägt eine typisierte semantische Verbindung zwischen zwei Wissensknoten vor

lifeos__accept_edge

Akzeptiert einen Verbindungsvorschlag (Schreibzugriff erforderlich)

lifeos__reject_edge

Lehnt einen Verbindungsvorschlag ab (Schreibzugriff erforderlich)

lifeos__read_pending_queue

Listet ausstehende Verbindungsvorschläge auf (immer schreibgeschützt)

Ressourcen

URI

Beschreibung

lifeos://identity

LifeOS-Identitätsprofil (identity.md)

lifeos://preferences

Benutzerpräferenzen (preferences.md)

lifeos://skills/{name}

Fähigkeitsdokumentation für ~/lifeos/skills/{name}/

lifeos://projects/{name}

Projektdefinition für ~/lifeos/projects/{name}.md

lifeos://wiki/{+path}

Wiki-Seite unter ~/lifeos/wiki/pages/{path}.md

lifeos://rules/{name}

Systemregel unter ~/lifeos/system/{name}.md

Alle Vorlagen-Ressourcen unterstützen das Auflisten — Clients können verfügbare Ressourcen aufzählen.

CLI-Unterbefehle

# List all rituals with id, title, and trigger summary
lifeos-mcp list

# Validate a ritual spec (structural check)
lifeos-mcp validate ~/lifeos/cadence/rituals/morning-review.md

# Render a ritual to a harness
lifeos-mcp render ~/lifeos/cadence/rituals/morning-review.md --to openclaw
lifeos-mcp render ~/lifeos/cadence/rituals/morning-review.md --to claude-code

Renderer-Schnittstelle (erweiterbar)

Renderer von Drittanbietern werden zur Laufzeit über registerRenderer eingebunden:

import { registerRenderer } from "lifeos-mcp/dist/renderers/index.js";

registerRenderer({
  name: "my-harness",
  async render(spec, body, ctx) {
    return {
      files: [{ path: "/out/job.json", content: JSON.stringify(spec) }],
      summary: `Rendered ${spec.id} to my-harness`,
    };
  },
});

Integrierte Renderer: openclaw (Cron-Job JSON), claude-code (Slash-Befehl + launchd plist).

Sicherheit

  • Alle Dateipfade werden validiert, um innerhalb des LifeOS-Stammverzeichnisses zu bleiben — kein Path-Traversal möglich.

  • Der Server ist standardmäßig schreibgeschützt; Schreib-Tools (lifeos__propose_edge, lifeos__accept_edge, lifeos__reject_edge) erfordern eine explizite Zustimmung über ~/Library/Application Support/LifeOS/mcp-write-config.json.

  • Nur Dateien unter ~/lifeos/ (oder LIFEOS_PATH) sind zugänglich.

Build

cd ~/lifeos-mcp
npm install
npm run build
# Output: dist/ + bin/lifeos-mcp.js

Lizenz

MIT

Install Server
F
license - not found
A
quality
C
maintenance

How are these scores calculated?

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/bwats/lifeos-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server