Operations

Status

Status and logs; every tool call is logged by kioku_mcp.audit:

systemctl status kioku-mcp
journalctl -u kioku-mcp -n 50

The health check needs no token:

curl -s http://127.0.0.1:8099/healthz

Recovery

Anki

Restore from a backup — anki_list_backups, then anki_restore_from_backup with a backup name and a search query, a dry run by default. Existing notes get their fields and tags back and keep their scheduling. Deleted notes are recreated with the same guid, and their scheduling restarts.

Full sync conflict — modifying an existing note type on a device forces a one-way full sync. When the replica holds unsynced changes, the service refuses to download over them, and every Anki tool returns the error. Sync the desktop app, then restart the service:

systemctl restart kioku-mcp

Rebuilding the replica — stop the service, move /var/lib/kioku-mcp/anki/collection.anki2 aside and start it again. It bootstraps with a fresh full download.

Trilium

Content — trilium_list_revisions and trilium_restore_revision.

Deletions — trilium_undelete_note, until Trilium erases the note: 7 days after deletion by default. To widen the window, raise the erase interval for deleted notes in Trilium’s Options, e.g. to 30 days.

Bulk edits — trilium_backup before editing many notes. The file lands in /var/lib/trilium/backup/backup-<name>.db; to keep a local copy:

ssh user@<server> 'sudo cat /var/lib/trilium/backup/backup-<name>.db' > <name>.db