Lorvex MCP server
Commit Nov 15, 2026Lets an AI assistant manage tasks, calendars, and habits through 120 specialized tools using a local-first, privacy-focused MCP server.
Also known as boyugou/lorvex
- Stars
- 6
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 15, 2026
- License
- Apache-2.0
What is Lorvex MCP?
Lorvex lets an AI assistant manage tasks, calendars, and habits through 120 specialized tools using a local-first, privacy-focused MCP server.
Summary generated from the project's README
About Lorvex MCP server
Managing your daily schedule, tasks, and habits through an AI assistant is what Lorvex enables. This MCP server provides 120 specialized tools that allow any MCP-capable client, such as Claude, to act as your primary planner. Instead of manually filling out forms, you use your assistant to capture tasks, plan days, and track habits through a natural interface.
This is a local-first solution where all data resides in a SQLite database on your device. It requires no external accounts and works offline. For users needing multi-device synchronization, it uses your own iCloud via CloudKit with encrypted payloads, ensuring that your data remains private and inaccessible to the developers.
Setting up the server involves running the LorvexMCPHost on a Mac with Apple silicon. Once connected via stdio, your assistant gains the ability to interact with your native Apple ecosystem, including macOS, iOS, and Apple Watch, while syncing events back to your system calendars through EventKit.
What you can do with it
- 1Automated daily planningAsk your AI assistant to organize your upcoming schedule and prepare a briefing for the day.
- 2Quick task captureHave your assistant turn a single line of text into a detailed task with deadlines and priorities.
- 3Habit tracking and reviewInstruct your assistant to manage your habit rings and perform a weekly review of your progress.
- 4Private multi-device synchronizationKeep your tasks and calendar in sync across your iPhone and Mac using your own encrypted iCloud storage.
Written from the project's README. Every use case is checked against a quote from it.
Automated checks
Ran Nov 15, 2026Full report →Not verified yet. A server needs a score of 80, no serious finding, and enough data for us to check. How checks work · What to fix for more points
- Source repository linked and reachableboyugou/lorvex is public and reachablegithub.com/boyugou/lorvex ↗Pass
- Package names this repository as its sourceNot checked
- Build provenance (Sigstore attestation)Not checked
- Open source license (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-13github.com/boyugou/lorvex ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNot checked
- No critical advisory in the package or its dependenciesNot checked
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubLorvex
The AI-native planner. Your assistant does the typing; you do the living.
Website · Download for Mac · Getting started · MCP setup · Documentation · Privacy
Lorvex is a task, calendar, and habit planner built MCP-first: the primary write interface is a Model Context Protocol server, so any MCP-capable AI assistant (Claude, or anything else that speaks MCP) can manage your tasks, plan your days, schedule your calendar, and track your habits through 120 typed tools. The native apps are calm, fast read surfaces with the human actions that matter — complete, defer, review — not a form-filling UI.
- Local-first. Everything lives in a SQLite database on your device. No accounts, no server of ours, fully usable offline.
- Private sync. Optional multi-device sync through your own iCloud (CloudKit private database) with encrypted payloads — multi-master, conflict-free (HLC clocks + last-writer-wins registers). We cannot read your data; there is nowhere for us to read it from.
- No embedded AI, no tracking. Lorvex ships no model, no analytics, no ads. Intelligence comes from your assistant, connected on your terms.
- Native everywhere. macOS, iPhone, iPad, Apple Watch, widgets, Shortcuts, Spotlight, and your system calendars through EventKit (events you create on the Mac are written back to Apple Calendar; iPhone and iPad read it).
- Thirty languages. The apps, widgets, and Shortcuts follow your system language, from Arabic to Vietnamese, right-to-left scripts included.
How it works
┌──────────────┐ MCP (stdio) ┌───────────────┐ ┌──────────────────┐
│ AI assistant │ ◄─────────────► │ LorvexMCPHost │ ◄────► │ Pure-Swift core │
│ (Claude, …) │ 120 tools │ (MCP server) │ │ SQLite (GRDB) │
└──────────────┘ └───────────────┘ └────────┬─────────┘
│ encrypted
┌──────────────┐ read / act ┌───────────────────────┐ │ envelopes
│ You │ ◄─────────────► │ Native apps & widgets │ ◄───────┴────────► your iCloud
└──────────────┘ └───────────────────────┘ (CloudKit private DB,
multi-master sync)
Every mutation — human or AI — flows through one audited write surface with idempotency keys and a changelog, then syncs as an encrypted envelope in your private CloudKit database. Other devices merge deterministically; no device is "the server."
Repository layout
The repository holds the Apple app plus the contracts it owns:
lorvex/
├── apps/
│ └── apple/ Apple-native app — Swift 6, SwiftUI/AppKit, SwiftPM.
├── schema/ SQLite schema (the Apple app's authority) + sync payload manifests.
├── cloudkit/ CloudKit record-type template and deploy tooling (Apple-owned).
├── spec/ Cross-implementation behavior contracts: docs + test-vector fixtures.
└── docs/ Project-level documentation (see docs/INDEX.md).
Lorvex began as a cross-platform Tauri app. That implementation was removed on 2026-09-17; this repository is the Apple-native app only.
Install
Mac: download Lorvex-macOS-arm64.dmg from the
latest release, open it,
and drag Lorvex to Applications. It needs a Mac with Apple silicon and macOS 26
or later, is notarized by Apple, and syncs with Lorvex on your other devices
through your iCloud account. The DMG does not update itself; the newest build
is always on the same releases page.
Getting started
Apple app (macOS)
Requires Xcode 26 or newer (Swift 6 toolchain); the app targets macOS 26, iOS 26, and watchOS 26.
cd apps/apple
swift build # build all targets
swift test # app-level test suite
(cd core && swift test) # pure-Swift core suite
./script/build_and_run.sh --verify # build, verify, and launch the macOS app
iOS / watchOS build through the XcodeGen-generated project — see
apps/apple/CLAUDE.md for the full developer manual
and apps/apple/docs/release.md for packaging.
Connect an AI assistant
With Lorvex installed, open Settings → Assistant and copy the setup prompt
or the config for your client. In Claude Code, the Lorvex plugin sets up the
connection and adds skills for planning a day, capturing tasks, the weekly
review, and tidying the assistant's memory
(plugins/lorvex):
/plugin marketplace add boyugou/lorvex
/plugin install lorvex@lorvex
From a source checkout, build the MCP host and point any MCP-capable client at it:
cd apps/apple && swift build -c release --product LorvexMCPHost
{
"mcpServers": {
"lorvex": {
"type": "stdio",
"command": "/path/to/lorvex/apps/apple/.build/release/LorvexMCPHost"
}
}
}
Full client-by-client instructions (Claude Desktop, Claude Code, and others):
apps/apple/docs/setup/ASSISTANT_MCP_SETUP.md.
Documentation
| Topic | Where |
|---|---|
| Documentation index | docs/INDEX.md |
| Design philosophy & non-goals | docs/vision/DESIGN_PHILOSOPHY.md |
| Assistant operating model (instructions, skills, tool design) | docs/design/AI_OPERATING_MODEL.md |
| Sync semantics (HLC, LWW, idempotency) | docs/design/SYNC_APPLY_SEMANTICS.md |
| Schema & data-infrastructure invariants | docs/design/SCHEMA_OPTIMALITY.md |
| Export / backup format | spec/EXPORT_FORMAT.md |
| Feature inventory | apps/apple/docs/reference/FEATURES.md |
| User guide | apps/apple/docs/USER_GUIDE.md |
| Roadmap & status | ROADMAP.md |
Status
Pre-release. The Apple app is feature-complete and in TestFlight, and a
notarized Mac build is on the
releases page; the data,
schema, sync, and backup contracts are finalized and gated by
repository verifiers (apps/apple/script/verify_all.sh). See
ROADMAP.md.
Privacy
Local data, your iCloud, our zero access — the full policy is in
PRIVACY.md. Lorvex collects nothing: no accounts, no
analytics, no telemetry, no third-party services.
Contributing & support
- Contributions: see
apps/apple/docs/CONTRIBUTING.md. - Issues and feature requests: GitHub Issues.
- Support: lorvex.app/support.
- Security issues: report them privately, as described in
SECURITY.md.
License
Lorvex MCP questions
How can I connect an AI assistant to Lorvex?
You can connect an AI assistant by copying the setup prompt or config from Settings → Assistant in the app, or by building the MCP host and pointing an MCP-capable client to it.
Is my data private?
Yes, Lorvex is local-first with everything stored in a SQLite database on your device, and optional sync uses your own encrypted iCloud database.
Does Lorvex use embedded AI?
No, Lorvex does not include any embedded models or tracking; it relies on your own connected AI assistant for intelligence.