Get public information about the configured Vikunja instance, including version and enabled settings. No auth token is required.

Get the authenticated Vikunja user profile and settings for the configured credentials.

List projects visible to the authenticated Vikunja user.

Get a single project by ID.

Create a new Vikunja project.

Update an existing Vikunja project.

Delete a project by ID.

List tasks across all accessible projects, with optional search, filtering, sorting, and expansions.

Get a single task by ID.

Create a task inside a project.

Update an existing task with PATCH-style semantics. By default only the fields you pass are changed; every other field keeps its current value (the MCP server reads the task first and merges your input on top). Set _replace: true to opt out and use Vikunja's native full-replacement behavior, which resets every unspecified field to its type default.

Delete a task by ID.

List labels visible to the authenticated user.

Create a new label.

List labels attached to a task.

Attach an existing label to a task.

Remove a label from a task.

List comments on a task.

Create a comment on a task.

Removes a saved filter. Raw Vikunja REST proxy for DELETE /filters/{id}. Removes a saved filter by its ID. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Delete a label. Raw Vikunja REST proxy for DELETE /labels/{id}. Delete an existing label. The user needs to be the creator of the label to be able to do this. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Deletes an existing bucket. Raw Vikunja REST proxy for DELETE /projects/{projectID}/views/{view}/buckets/{bucketID}. Deletes an existing kanban bucket and dissociates all of its task. It does not delete any tasks. You cannot delete the last bucket on a project. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Remove a project background. Raw Vikunja REST proxy for DELETE /projects/{id}/background. Removes a previously set project background, regardless of the project provider used to set the background. It does not throw an error if the project does not have a background. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Delete a team from a project. Raw Vikunja REST proxy for DELETE /projects/{projectID}/teams/{teamID}. Delets a team from a project. The team won't have access to the project anymore. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Delete a project view. Raw Vikunja REST proxy for DELETE /projects/{project}/views/{id}. Deletes a project view. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Delete a user from a project. Raw Vikunja REST proxy for DELETE /projects/{projectID}/users/{userID}. Delets a user from a project. The user won't have access to the project anymore. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Deletes a project. Raw Vikunja REST proxy for DELETE /projects/{id}. Delets a project This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Remove a link share. Raw Vikunja REST proxy for DELETE /projects/{project}/shares/{share}. Remove a link share. The user needs to have write-access to the project to be able do this. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Deletes an existing webhook target. Raw Vikunja REST proxy for DELETE /projects/{id}/webhooks/{webhookID}. Delete any of the project's webhook targets. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Unsubscribe the current user from an entity.. Raw Vikunja REST proxy for DELETE /subscriptions/{entity}/{entityID}. Unsubscribes the current user to an entity. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Remove a task comment. Raw Vikunja REST proxy for DELETE /tasks/{taskID}/comments/{commentID}. Remove a task comment. The user doing this need to have at least write access to the task this comment belongs to. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Remove a label from a task. Raw Vikunja REST proxy for DELETE /tasks/{task}/labels/{label}. Remove a label from a task. The user needs to have write-access to the project to be able do this. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Delete a task. Raw Vikunja REST proxy for DELETE /tasks/{id}. Deletes a task from a project. This does not mean "mark it done". This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Delete an assignee. Raw Vikunja REST proxy for DELETE /tasks/{taskID}/assignees/{userID}. Un-assign a user from a task. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Delete an attachment. Raw Vikunja REST proxy for DELETE /tasks/{id}/attachments/{attachmentID}. Delete an attachment. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Remove a task relation. Raw Vikunja REST proxy for DELETE /tasks/{taskID}/relations/{relationKind}/{otherTaskID}. Pass the JSON request payload in the optional body field. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Deletes a team. Raw Vikunja REST proxy for DELETE /teams/{id}. Delets a team. This will also remove the access for all users in that team. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Remove a user from a team. Raw Vikunja REST proxy for DELETE /teams/{id}/members/{username}. Remove a user from a team. This will also revoke any access this user might have via that team. A user can remove themselves from the team if they are not the last user in the team. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Truncate all tables. Raw Vikunja REST proxy for DELETE /test/all. Removes all data from every Vikunja table. Used by e2e tests to ensure clean state before each test. Requires the testing token. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Deletes an existing api token. Raw Vikunja REST proxy for DELETE /tokens/{tokenID}. Delete any of the user's api tokens. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Delete a caldav token by id. Raw Vikunja REST proxy for DELETE /user/settings/token/caldav/{id}. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Delete a user-level webhook target. Raw Vikunja REST proxy for DELETE /user/settings/webhooks/{id}. Delete a user-level webhook target. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Get an unsplash image. Raw Vikunja REST proxy for GET /backgrounds/unsplash/image/{image}. Get an unsplash image. Returns json on error. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Get an unsplash thumbnail image. Raw Vikunja REST proxy for GET /backgrounds/unsplash/image/{image}/thumb. Get an unsplash thumbnail image. The thumbnail is cropped to a max width of 200px. Returns json on error. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Search for a background from unsplash. Raw Vikunja REST proxy for GET /backgrounds/unsplash/search. Search for a project background from unsplash This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Gets one saved filter. Raw Vikunja REST proxy for GET /filters/{id}. Returns a saved filter by its ID. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Info. Raw Vikunja REST proxy for GET /info. Returns the version, frontendurl, motd and various settings of Vikunja This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is not required.

Get all reactions for an entity. Raw Vikunja REST proxy for GET /{kind}/{id}/reactions. Returns all reactions for an entity This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Get all labels a user has access to. Raw Vikunja REST proxy for GET /labels. Returns all labels which are either created by the user or associated with a task the user has at least read-access to. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Gets one label. Raw Vikunja REST proxy for GET /labels/{id}. Returns one label by its ID. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Get migration status. Raw Vikunja REST proxy for GET /migration/vikunja-file/status. Returns if the current user already did the migation or not. This is useful to show a confirmation message in the frontend if the user is trying to do the same migration again. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Get migration status. Raw Vikunja REST proxy for GET /migration/ticktick/status. Returns if the current user already did the migation or not. This is useful to show a confirmation message in the frontend if the user is trying to do the same migration again. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Get migration status. Raw Vikunja REST proxy for GET /migration/microsoft-todo/status. Returns if the current user already did the migation or not. This is useful to show a confirmation message in the frontend if the user is trying to do the same migration again. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Get migration status. Raw Vikunja REST proxy for GET /migration/trello/status. Returns if the current user already did the migation or not. This is useful to show a confirmation message in the frontend if the user is trying to do the same migration again. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Get migration status. Raw Vikunja REST proxy for GET /migration/todoist/status. Returns if the current user already did the migation or not. This is useful to show a confirmation message in the frontend if the user is trying to do the same migration again. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Get migration status. Raw Vikunja REST proxy for GET /migration/wekan/status. Returns if the current user already did the migration or not. This is useful to show a confirmation message in the frontend if the user is trying to do the same migration again. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Get the auth url from todoist. Raw Vikunja REST proxy for GET /migration/todoist/auth. Returns the auth url where the user needs to get its auth code. This code can then be used to migrate everything from todoist to Vikunja. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Get the auth url from Microsoft Todo. Raw Vikunja REST proxy for GET /migration/microsoft-todo/auth. Returns the auth url where the user needs to get its auth code. This code can then be used to migrate everything from Microsoft Todo to Vikunja. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Get the auth url from trello. Raw Vikunja REST proxy for GET /migration/trello/auth. Returns the auth url where the user needs to get its auth code. This code can then be used to migrate everything from trello to Vikunja. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Get CSV migration status. Raw Vikunja REST proxy for GET /migration/csv/status. Returns if the current user already did the CSV migration or not. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Get all notifications for the current user. Raw Vikunja REST proxy for GET /notifications. Returns an array with all notifications for the current user. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Gets one project. Raw Vikunja REST proxy for GET /projects/{id}. Returns a project by its ID. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Get the project background. Raw Vikunja REST proxy for GET /projects/{id}/background. Get the project background of a specific project. Returns json on error. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Get users on a project. Raw Vikunja REST proxy for GET /projects/{id}/users. Returns a project with all users which have access on a given project. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Get tasks in a project. Raw Vikunja REST proxy for GET /projects/{id}/views/{view}/tasks. Returns all tasks for the selected project. When the requested view is a kanban view, a list of buckets containing the tasks will be returned. Otherwise, a list of tasks will be returned. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Get one task by its per-project index. Raw Vikunja REST proxy for GET /projects/{project}/tasks/by-index/{index}. Returns a single task identified by its per-project index. Useful when resolving human-readable references like "PROJ-42" to a canonical task object. Note that task indexes are reassigned when a task is moved between projects, so long-lived references should use the returned task id instead. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Get one link shares for a project. Raw Vikunja REST proxy for GET /projects/{project}/shares/{share}. Returns one link share by its ID. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Get all kanban buckets of a project. Raw Vikunja REST proxy for GET /projects/{id}/views/{view}/buckets. Returns all kanban buckets which belong to that project. Buckets are always sorted by their position in ascending order. To get all buckets with their tasks, use the tasks endpoint with a kanban view. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Get all link shares for a project. Raw Vikunja REST proxy for GET /projects/{project}/shares. Returns all link shares which exist for a given project This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Get users. Raw Vikunja REST proxy for GET /projects/{id}/projectusers. Lists all users (without emailadresses). Also possible to search for a specific user. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Get teams on a project. Raw Vikunja REST proxy for GET /projects/{id}/teams. Returns a project with all teams which have access on a given project. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Get all api webhook targets for the specified project. Raw Vikunja REST proxy for GET /projects/{id}/webhooks. Get all api webhook targets for the specified project. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Get all project views for a project. Raw Vikunja REST proxy for GET /projects/{project}/views. Returns all project views for a sepcific project This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Get one project view. Raw Vikunja REST proxy for GET /projects/{project}/views/{id}. Returns a project view by its ID. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Get all projects a user has access to. Raw Vikunja REST proxy for GET /projects. Returns all projects a user has access to. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Get a list of all token api routes. Raw Vikunja REST proxy for GET /routes. Returns a list of all API routes which are available to use with an api token, not a user login. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Get a task comment. Raw Vikunja REST proxy for GET /tasks/{taskID}/comments/{commentID}. Get a task comment. The user doing this need to have at least read access to the task this comment belongs to. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Get all attachments for one task.. Raw Vikunja REST proxy for GET /tasks/{id}/attachments. Get all task attachments for one task. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Get tasks. Raw Vikunja REST proxy for GET /tasks. Returns all tasks on any project the user has access to. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Get all assignees for a task. Raw Vikunja REST proxy for GET /tasks/{taskID}/assignees. Returns an array with all assignees for this task. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Get one task. Raw Vikunja REST proxy for GET /tasks/{id}. Returns one task by its ID This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Get one attachment.. Raw Vikunja REST proxy for GET /tasks/{id}/attachments/{attachmentID}. Get one attachment for download. Returns json on error. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Get all task comments. Raw Vikunja REST proxy for GET /tasks/{taskID}/comments. Get all task comments. The user doing this need to have at least read access to the task. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Get all labels on a task. Raw Vikunja REST proxy for GET /tasks/{task}/labels. Returns all labels which are assicociated with a given task. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Gets one team. Raw Vikunja REST proxy for GET /teams/{id}. Returns a team by its ID. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Get teams. Raw Vikunja REST proxy for GET /teams. Returns all teams the current user is part of. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Get all api tokens of the current user. Raw Vikunja REST proxy for GET /tokens. Returns all api tokens the current user has created. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Totp QR Code. Raw Vikunja REST proxy for GET /user/settings/totp/qrcode. Returns a qr code for easier setup at end user's devices. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Get user information. Raw Vikunja REST proxy for GET /user. Returns the current user object with their settings. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Returns the caldav tokens for the current user. Raw Vikunja REST proxy for GET /user/settings/token/caldav. Return the IDs and created dates of all caldav tokens for the current user. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Get current user data export. Raw Vikunja REST proxy for GET /user/export. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Return user avatar setting. Raw Vikunja REST proxy for GET /user/settings/avatar. Returns the current user's avatar setting. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Totp setting for the current user. Raw Vikunja REST proxy for GET /user/settings/totp. Returns the current user totp setting or an error if it is not enabled. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Get all available time zones on this vikunja instance. Raw Vikunja REST proxy for GET /user/timezones. Because available time zones depend on the system Vikunja is running on, this endpoint returns a project of all valid time zones this particular Vikunja instance can handle. The project of time zones is not sorted, you should sort it on the client. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Get available user-directed webhook events. Raw Vikunja REST proxy for GET /user/settings/webhooks/events. Get all webhook events that can be used with user-level webhook targets. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Get all user-level webhook targets. Raw Vikunja REST proxy for GET /user/settings/webhooks. Get all webhook targets configured for the current user (not project-specific). This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

User Avatar. Raw Vikunja REST proxy for GET /{username}/avatar. Returns the user avatar as image. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is not required.

Get users. Raw Vikunja REST proxy for GET /users. Search for a user by its username, name or full email. Name (not username) or email require that the user has enabled this in their settings, unless both users share an external team (synced via OIDC/LDAP), in which case they can always find each other. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Get all possible webhook events. Raw Vikunja REST proxy for GET /webhooks/events. Get all possible webhook events to use when creating or updating a webhook target. This endpoint does not usually require a request body. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.

Reset the db to a defined state. Raw Vikunja REST proxy for PATCH /test/{table}. Fills the specified table with the content provided in the payload. You need to enable the testing endpoint before doing this and provide the Authorization: <token> secret when making requests to this endpoint. See docs for more details. Pass the JSON request payload in the optional body field. Path and query parameters are top-level fields. Original parameter names also accept camelCase and snake_case aliases. Authentication is required.