selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

MulmoClaude logo

Self-host MulmoClaude

v2.10.0

Local-first AI assistant with wiki and messaging bridges

ReleaseOpen SourceMIT
Updated9 hours ago
LanguageTypescript
Setup difficultyModerate
MobileResponsive
Stars
386
Ports
3001 (Production server (launched via npx mulmoclaude)), 5173 (Vite dev client (launched via yarn dev))
Requires
Claude Code CLI, Node.js
Install with macOS

What is MulmoClaude?

MulmoClaude is a local-first AI assistant platform you run on your own computer. It uses Claude Code as the AI backend and provides a personal wiki the assistant builds and maintains, schema-driven collections for structured data like todos and contacts, RSS/Atom feed aggregation, a scheduler for recurring tasks, and a plugin system including accounting and SEC filings tools. You interact through a web UI at localhost:3001 (production) or localhost:5173 (development), and can also connect from messaging apps like Telegram, Slack, Discord, LINE, WhatsApp, Matrix, and many others via separate bridge processes. All data — memories, wiki pages, collections, feeds, scheduled tasks — stays as plain files in a workspace directory (default ~/mulmoclaude). An optional Docker sandbox isolates the AI's file access. The project is MIT-licensed and published on npm as mulmoclaude.

Should you self-host MulmoClaude?

MulmoClaude scores 51/100 on selfhost.directory (how scoring works) and ranks #33 of 120 in AI Assistant. It has 386 GitHub stars.

It shipped 8 stable releases in the past year. The latest, v2.10.0, came out on 26 October 2026.

Setup is moderate: expect some configuration beyond a single command. It is MIT-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is hermes-agent (89/100, 257 957 stars). It scores higher overall, so compare the two before you pick. See MulmoClaude vs hermes-agent side by side.

Features

  • Remote Access from Phone

MulmoClaude README

How to install MulmoClaude

Install MulmoClaude with macOS

macOS, Node.js, npx, Claude Code

npx mulmoclaude@latest create-shortcut

This writes MulmoClaude.app to /Applications (or ~/Applications if not writable — pass --dir to choose, --yes to skip prompt). Double-clicking it checks prerequisites, shows progress page while server starts, and opens the app when ready.

Reads ~/.env for config. Re-run after upgrading.

How to configure MulmoClaude

  • DISABLE_SANDBOXDisable Docker sandbox even when Docker is installed (1 = disabled).

    Disable Docker sandbox even when Docker is installed (1 = disabled).

    values: 1

  • GEMINI_API_KEYEnables Gemini image generation and editing. Without it, image plugins surface a UI warning.

    Enables Gemini image generation and editing. Without it, image plugins surface a UI warning.

    values: API key from Google AI Studio

  • MULMOCLAUDE_AUTH_TOKENPin a fixed bearer token across restarts (useful for bridges on different machines). Recommended: at least 32 random characters.

    Pin a fixed bearer token across restarts (useful for bridges on different machines). Recommended: at least 32 random characters.

    values: Long random string

  • MULMOCLAUDE_TRUSTED_ORIGINSCSRF-guard allowlist for cross-origin state-changing requests. Comma-separated Origins with scheme and port, no trailing slash.

    CSRF-guard allowlist for cross-origin state-changing requests. Comma-separated Origins with scheme and port, no trailing slash.

    values: e.g. http://192.168.1.42:5173

  • MULMOCLAUDE_WORKSPACE_PATH~/mulmoclaudeAbsolute path to the workspace directory (default: ~/mulmoclaude).

    Absolute path to the workspace directory (default: ~/mulmoclaude).

    values: Absolute path

  • SANDBOX_MOUNT_CONFIGSComma-separated list of allowlisted config mounts for sandbox (e.g., gh,gitconfig).

    Comma-separated list of allowlisted config mounts for sandbox (e.g., gh,gitconfig).

    values: gh,gitconfig

  • SANDBOX_SSH_AGENT_FORWARDForward host SSH agent into Docker sandbox (1 = enabled). Private keys stay on host.

    Forward host SSH agent into Docker sandbox (1 = enabled). Private keys stay on host.

    values: 1

  • TYPESAFE_API_KEYRequired by manageKenteiScript tool (Tutor role) for TypeSafe JEV quiz grading.

    Required by manageKenteiScript tool (Tutor role) for TypeSafe JEV quiz grading.

    values: API key from typesafe.ai

  • VITE_LOCALEenClient locale for vue-i18n. Supported: en, ja, zh, ko, es, pt-BR, fr, de. Picked up at build/dev time.

    Client locale for vue-i18n. Supported: en, ja, zh, ko, es, pt-BR, fr, de. Picked up at build/dev time.

    values: en, ja, zh, ko, es, pt-BR, fr, de

MulmoClaude releases & version history

FAQ

There's no Calendar or Kanban button

Calendar and Kanban views require specific field types in the schema (date for Calendar, status enum for Kanban). Ask Claude to add the needed fields.

The collection I made doesn't show up

Reopen the Collections page (reload the browser tab). The list is rebuilt every time it opens. If it still isn't there, the blueprint may be broken. Ask in chat: "My … collection doesn't show up in the list. Check its schema.json and fix it."

More in Personal Productivity

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…