Advertise
MCP.so
Sign In

Vikunja MCP Server

@democratize-technology

Repository

Basic information

Category

Other

License

MIT

Transports

stdio

Author

democratize-technology

About Vikunja MCP Server

Model Context Protocol server for Vikunja task management. Enables AI assistants to interact with Vikunja instances via MCP.

#productivity#typescript#mcp#task-management#ai-tools#vikunja#model-context-protocol

Vikunja MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "vikunja": {
      "command": "npx",
      "args": [
        "-y",
        "@democratize-technology/vikunja-mcp"
      ],
      "env": {
        "VIKUNJA_URL": "https://your-vikunja-instance.com/api/v1",
        "VIKUNJA_API_TOKEN": "your-api-token"
      }
    }
  }
}

Vikunja MCP Server tools

9

Overview

What is Vikunja MCP Server?

A Model Context Protocol (MCP) server that enables AI assistants to interact with Vikunja task management instances. It provides subcommand-based tools for full task, project, label, team, user, and webhook management.

How to use Vikunja MCP Server?

Install via npx -y @democratize-technology/vikunja-mcp or build locally, then configure environment variables VIKUNJA_URL and VIKUNJA_API_TOKEN (or JWT token) in your MCP client. Use subcommand tools like vikunja_tasks.create and vikunja_auth.connect after authentication.

Key features of Vikunja MCP Server

  • Subcommand-based tools for intuitive AI interactions
  • Full task, project, label, and team management
  • Batch import tasks from CSV or JSON files
  • Zod-based input validation and DoS protection
  • Production‑ready retry logic with circuit breaker
  • Automatic API token or JWT detection

Use cases of Vikunja MCP Server

  • Automate task creation and updates via AI assistants
  • Manage projects and labels through natural language commands
  • Bulk import tasks from CSV/JSON files into Vikunja
  • Retrieve and organize tasks with advanced filtering and sorting

Frequently asked questions

1

What authentication methods are supported?

Supports API tokens (starting with `tk_`) for most operations and JWT tokens (starting with `eyJ`) for full access including user management and export. Token type is automatically detected.

2

What are the runtime requirements?

Requires Node.js 20+ (LTS only) and an existing Vikunja instance with API access.

3

How do I obtain an API token?

Go to Vikunja Settings → API Tokens → Create new token. The token format starts with `tk_`.

4

Are there rate limits or memory protections?

Yes, the server includes configurable rate limiting against DoS attacks and memory protection with pagination limits and usage monitoring.

5

Can I use JWT tokens for user management?

Yes, JWT tokens enable access to user‑specific endpoints (profile, settings, export) which are not available with API tokens.

Comments

More Other MCP servers

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K

Awesome Mlops

visenger

A curated list of references for MLOps

14.0K

MaxKB

1Panel-dev

🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。

22.0K

The Living Bread

The Living Bread

A free remote MCP server for The Living Bread. Bible passages read word for word from a stored public domain text with an evidence label, keyword search and cross references, real churches, gatherings and prayer groups w

Advertise