Nemeton Mcp
About
# Nemeton MCP Server [](https://swift.org) [](https://apple.com/macos) [](LICENSE)…
Explore
- 50+ tools across VM lifecycle, console, snapshots, networking, GUI, and more.
- CoW snapshots on APFS – save VM states without wasting disk.
- Automatic ISO / IPSW download for Linux and macOS distributions.
- GUI control, clipboard bridge, and file transfer capabilities.
- Webhooks for asynchronous event notifications.
- 100% local – no cloud, no telemetry, no subscription.
1. macOS 14 (Sonoma) or later — required for Virtualization.framework features.
2. Nemeton app installed and running — get it here.
3. Swift 5.9+ (Xcode 15+) if you want to build from source. Pre-built binaries are also available.
| Variable | Default | Description |
|---|---|---|
| NEMETON_PORT | 22100 | Port of Nemeton's local HTTP server |
| NEMETON_TOKEN | _(none)_ | Bearer token from Nemeton Settings (required for write operations) |
Errors and trace logs are written to stderr so they don't pollute the JSON-RPC stdout channel.
---
Control native macOS virtual machines from Claude Desktop, Claude Code, Cursor, or any MCP client.
This is the official Model Context Protocol bridge for Nemeton — a native macOS app that creates and manages Linux and macOS VMs using Apple's Virtualization.framework (no Parallels, no VMware, no subscriptions).
> You need the Nemeton app installed and running. This MCP server is a thin stdio→HTTP bridge — the actual VM logic lives in the app. Get Nemeton at store.juergenkoller.software/apps/nemeton.
---
What you can do
> "Claude, spin up an Ubuntu 24.04 VM with 4 CPUs and 8 GB RAM, install Docker, and tell me when it's ready."
The MCP server exposes 50+ tools across these categories:
| Category | Tools |
|---|---|
| VM Lifecycle | list_vms, get_vm, create_vm, update_vm, clone_vm, delete_vm, reorder_vms, stop_all |
| VM Control | start_vm, stop_vm, force_stop_vm, pause_vm, resume_vm, suspend_vm, get_suspend_status |
| Snapshots (CoW on APFS) | list_snapshots, create_snapshot, restore_snapshot, delete_snapshot |
| Console | send_console, read_console, console_execute, take_screenshot |
| Networking & Files | vm_ip, ssh_execute, file_upload, file_download, file_list |
| GUI Control | gui_launch, gui_windows, vscode_command, select_vm |
| Clipboard Bridge | clipboard_read, clipboard_write |
| Host Info | get_host_info, get_metrics |
| Storage | resize_disk, export_vm, import_vm |
| Distros | list_distros (Ubuntu, Debian, Fedora, Arch — auto-download ISOs) |
| Display | fullscreen_enter, fullscreen_exit, fullscreen_toggle |
| Webhooks | list_webhooks, register_webhook, delete_webhook |
| Runtime | vm_runtime, vm_errors, list_downloads |
Each tool returns structured JSON with VM state, snapshot metadata, console output, or operation result.
---
Installation
Prerequisites
1. macOS 14 (Sonoma) or later — required for Virtualization.framework features.
2. Nemeton app installed and running — get it here.
3. Swift 5.9+ (Xcode 15+) if you want to build from source. Pre-built binaries are also available.
Build from source
```bash
git clone https://github.com/juergenkoller-software/nemeton-mcp.git
cd nemeton-mcp
swift build -c release
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
