Vikunja tasks for MCP clients: list and read tasks and projects; with --writable, change them.
Connect Runs on your machine
claude mcp add emperor-vikunja -e VIKUNJA_URL=<VIKUNJA_URL> -e VIKUNJA_TOKEN=<VIKUNJA_TOKEN> -e VIKUNJA_WRITABLE=<VIKUNJA_WRITABLE> -- emperor-vikunja{
"mcpServers": {
"emperor-vikunja": {
"command": "emperor-vikunja",
"args": [],
"env": {
"VIKUNJA_URL": "<VIKUNJA_URL>",
"VIKUNJA_TOKEN": "<VIKUNJA_TOKEN>",
"VIKUNJA_WRITABLE": "<VIKUNJA_WRITABLE>"
}
}
}
}{
"mcpServers": {
"emperor-vikunja": {
"command": "emperor-vikunja",
"args": [],
"env": {
"VIKUNJA_URL": "<VIKUNJA_URL>",
"VIKUNJA_TOKEN": "<VIKUNJA_TOKEN>",
"VIKUNJA_WRITABLE": "<VIKUNJA_WRITABLE>"
}
}
}
}{
"servers": {
"emperor-vikunja": {
"type": "stdio",
"command": "emperor-vikunja",
"args": [],
"env": {
"VIKUNJA_URL": "<VIKUNJA_URL>",
"VIKUNJA_TOKEN": "<VIKUNJA_TOKEN>",
"VIKUNJA_WRITABLE": "<VIKUNJA_WRITABLE>"
}
}
}
}Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
VIKUNJA_URLRequired | Address of your Vikunja, e.g. https://vikunja.example.com |
VIKUNJA_TOKENRequired, secret | Vikunja API token (Settings > API Tokens) |
VIKUNJA_WRITABLEOptional | Set to true to also serve the write tools (same as --writable); unset, empty or false keeps the server read-only. |
Details
| Package | [email protected] (CARGO, stdio) |
| First published | 2 Nov 2026 |
| Last updated | 2 Nov 2026 |
| Registry name | io.github.yarenty/emperor-vikunja |
More productivity servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.