vikunja-mcp

Version: 0.0.10

Capabilities

• Projects: List, create, read, update, delete; create child projects directly with parent_project_id
• Tasks: Full CRUD with comments, attachments, labels
• Labels: Manage project and task labels
• Notifications: Read and manage notifications
• Files: Upload and manage task attachments
• Comments: Add and read task comments

Supported Platforms

• Linux
• macOS

Requirements

• Python 3.11+
• Access to a Vikunja instance with API token

Installation

git clone <repo-url>
cd vikunja-mcp
./install.sh

The installer will:

1. Detect your OS (Linux/macOS) and verify Python 3.11+
2. Create a virtual environment at ~/.vikunja-mcp/env/
3. Install the vikunja_mcp package and dependencies
4. Copy the launcher script to ~/.vikunja-mcp/mcp/run_mcp.sh
5. Prompt for your Vikunja URL and API token
6. Register the MCP server with OpenCode
7. Test the connection to your Vikunja instance

Uninstallation

./uninstall.sh

Configuration

Configuration is stored in ~/.vikunja-mcp/config.json and registered in OpenCode's opencode.json.

Collaborators

• FErArg (ferarg.com) — Project Owner
• Deepseek — AI assistant
• Miramax — AI assistant
• Kimi — AI assistant

License

GPLv3 — see LICENSE