How do I install the vikunja mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `VIKUNJA_URL`, `VIKUNJA_API_TOKEN` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Vikunja MCP Server

Security-first MCP server for Vikunja — full API coverage, read-only by default with opt-in write/delete, and just one dependency (the official MCP

Local serverstdio

What is the Vikunja MCP Server?

Security-first MCP server for Vikunja — full API coverage, read-only by default with opt-in write/delete, and just one dependency (the official MCP SDK).

What the server does

The available third-party Vikunja MCP servers pull a dozen-plus dependencies from npm at runtime and run inside the agent's container with access to its secrets. This one is the opposite:

One direct dependency — — the official @modelcontextprotocol/sdk. All HTTP
One egress point — — every request goes through makeApi() in api.js
Scoped by default — — read and additive tools are always on (list, get, create
Secrets from env — , never hardcoded
No build step — — plain Node ESM, node index.js

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
list_projects	read
get_project	read
list_tasks	read
list_all_tasks	read
get_task	read
list_labels	read
search_users	read
list_task_assignees	read
list_task_comments	read
list_task_relations	read
list_task_attachments	read
list_buckets	read
list_teams	read
get_team	read

How to install the Vikunja MCP Server

{
  "mcpServers": {
    "vikunja": {
      "command": "npx",
      "args": ["-y", "@eargollo/vikunja-mcp"],
      "env": {
        "VIKUNJA_URL": "your-value",
        "VIKUNJA_API_TOKEN": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

Variable	Description	Required
VIKUNJA_URL	Endpoint or connection string the server talks to.	Yes
VIKUNJA_API_TOKEN	Credential the server authenticates with.	Yes

Example prompts to try

“Use Vikunja to list projects.”
“Use Vikunja to get project.”
“Use Vikunja to list tasks.”

Frequently asked questions

Security-first MCP server for Vikunja — full API coverage, read-only by default with opt-in write/delete, and just one dependency (the official MCP SDK). Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.

Alternatives to the Vikunja MCP Server

Filesystem

Official

Read, search and edit files inside allowed directories with the Model Context Protocol reference Filesystem server.

File Systems & StorageTypeScript★ 63.0k

Context7

Official

Retrieve version-aware library documentation and code examples with Context7 MCP, using resolve-library-id and query-docs.

Documentation & API ReferencesRemoteTypeScript★ 32.0k

App Store Connect

An MCP server, written in Rust, that exposes the Apple App Store Connect API to AI agents. It covers the full product lifecycle — apps & metadata, in-app purchases, subscriptions and their offers…

Developer Tools

AgentDrop

Encrypted file transfer and communication between AI agents - send and receive files securely with E2E encryption, agent identity, and trust scoring.

Developer ToolsTypeScript

MCP Code Understanding

If you try Windows and encounter issues, please open an issue so we can improve cross-platform support.

Developer ToolsPython

Sociavault-mcp

Give your AI assistant live access to social media data. This Model Context Protocol server lets Claude, Cursor, Cline, VS Code, and any MCP-compatible client pull real-time data from 11 platforms —…

Social Media & Marketing