Vikunjamcp
Let your coding agent create, update, and query tasks on your self-hosted Vikunja instance without leaving the chat.
Overview
io.github.idjohnson/vikunjamcp is a MCP server for the Build phase that connects coding agents to your self-hosted Vikunja task management API.
What is this MCP server?
- Stdio MCP bridge to any Vikunja instance you host
- Docker OCI package: docker.io/idjohnson/vikunjamcp
- Requires VIKUNJA_URL, VIKUNJA_USERNAME, and VIKUNJA_PASSWORD
- Version 1.0.26 on MCP server schema 2025-09-29
- Keeps task data on your infra instead of a SaaS PM API
- Server version 1.0.26
- Stdio transport
- 3 required environment variables
What problem does it solve?
You run Vikunja for tasks but your agent cannot see or update that backlog without manual exports or browser context.
Who is it for?
Solo builders self-hosting Vikunja who want agent-driven task updates during feature work.
Skip if: Teams that need a hosted Notion/Linear MCP or have no Vikunja instance running.
What do I get? / Deliverables
After you configure URL and credentials, your agent can manage Vikunja tasks in the same session where you write and ship code.
- Agent-callable access to Vikunja task and project operations
- Configured Docker OCI MCP entry in your agent toolchain
- Unified backlog updates from coding sessions
Recommended MCP Servers
Journey fit
Backlog and task boards sit in the Build phase when you are actively shipping features and need PM tooling wired into the agent. PM subphase covers issue trackers and task systems—Vikunja is explicitly a self-hosted task management backend.
How it compares
MCP integration to Vikunja, not a standalone planning skill or generic todo app.
Common Questions / FAQ
Who is io.github.idjohnson/vikunjamcp for?
It is for developers who already use Vikunja on their own server and want Claude Code, Cursor, or similar agents to read and change tasks through MCP.
When should I use io.github.idjohnson/vikunjamcp?
Use it during Build and Operate when you want the agent to sync implementation work with Vikunja boards instead of maintaining a parallel task list in chat.
How do I add io.github.idjohnson/vikunjamcp to my agent?
Register the stdio server using the OCI image docker.io/idjohnson/vikunjamcp:0.26 and set VIKUNJA_URL, VIKUNJA_USERNAME, and VIKUNJA_PASSWORD in your MCP host config.