Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
VIKUNJA_URLYesInstance URL. https://host, .../api, .../api/v1 and .../api/v2 are all normalised to /api/v2.
VIKUNJA_TOKENYesAPI token (tk_...) or JWT, sent as Authorization: Bearer.
VIKUNJA_TIMEOUTNoHTTP timeout, seconds.30
VIKUNJA_MCP_HOSTNoBind address for HTTP transports.127.0.0.1
VIKUNJA_MCP_PORTNoPort for HTTP transports.8000
VIKUNJA_VERIFY_SSLNoTLS verification.true
VIKUNJA_MCP_TRANSPORTNostdio, http, sse or streamable-http.stdio
VIKUNJA_REMOVED_LABELNoLabel used instead of deleting.removed_by_label
VIKUNJA_DEFAULT_PROJECT_IDNoProject used by create_task when project_id is omitted.
VIKUNJA_DESCRIPTION_FORMATNomarkdown or html for rich-text fields.markdown
VIKUNJA_AUTO_CREATE_REMOVED_LABELNoCreate that label on first use.true

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}
logging
{}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
extensions
{
  "io.modelcontextprotocol/ui": {}
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
list_tasksA

List tasks, optionally scoped to one project.

Tasks marked as removed are hidden unless include_removed is true. When the removal filter is applied and filter_include_nulls was not set explicitly, it defaults to true so that tasks without any label are still returned.

get_taskA

Read a single task by id, including its labels and assignees.

create_taskA

Create a task in a project.

Falls back to VIKUNJA_DEFAULT_PROJECT_ID when project_id is omitted.

update_taskA

Partially update a task; omitted fields are left untouched.

Setting project_id moves the task to another project. Use clear_fields to explicitly empty a field instead of changing it.

remove_taskA

Mark a task as removed by attaching the configured removal label.

Nothing is deleted: the task stays in Vikunja and is simply hidden from list_tasks. Use restore_task to undo.

restore_taskA

Undo remove_task by detaching the removal label.

add_task_labelsA

Attach labels to a task, creating any that do not exist yet.

list_projectsA

List projects visible to the configured token, with their numeric ids.

get_projectA

Read a single project by id.

create_projectA

Create a project, optionally nested under a parent project.

list_labelsA

List labels, useful for building filter expressions that need label ids.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/semaputnik/vikunjia-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server