Skip to content
Ukkora

MCP Server

Connect AI assistants (Claude Desktop, Cursor) to Ukkora using the Model Context Protocol.

Overview

Ukkora includes an MCP (Model Context Protocol) server that lets AI assistants read and manage tasks directly — without any custom integration code.

Once configured, your assistant can:

  • list your workspaces and tasks
  • create tasks on your behalf
  • update deadlines and assignments
  • mark tasks as done

Requirements

  • Node.js 20 or later
  • An Ukkora integration token — create one in Settings → API Tokens

Setup

Claude Desktop

Locate your claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the following:

{
  "mcpServers": {
    "ukkora": {
      "command": "node",
      "args": ["/absolute/path/to/ukkora/mcp/index.js"],
      "env": {
        "UKKORA_TOKEN": "ukkora_your_token_here"
      }
    }
  }
}

Restart Claude Desktop. You should see Ukkora listed under connected tools.

Cursor

In Cursor settings, add an MCP server with the same command, args, and env configuration.

Available tools

ToolDescription
list_workspacesList all workspaces (teams) accessible with your token
list_tasksList tasks — filter by workspace, assignee, or status
get_taskGet a specific task by ID
create_taskCreate a new task in a workspace
update_taskUpdate title, description, deadline, or assignee
complete_taskMark a task as completed
uncomplete_taskReopen a completed task

Example interaction

Once connected, you can ask your assistant naturally:

"Show me open tasks in my team" "Create a task: Review Q2 report, due June 30" "Mark task abc123 as done"

The assistant will call the appropriate Ukkora tool and confirm the action.

Security

  • All actions run under the scope of your token — the assistant only sees workspaces and tasks you have access to
  • Tokens can be revoked at any time in Settings → API Tokens
  • No data leaves Ukkora except what the assistant explicitly requests

Configuration reference

Environment variableRequiredDescription
UKKORA_TOKEN✓Integration token from Settings → API Tokens
UKKORA_BASE_URL—Override API base URL (default: <SiteUrl />)

Usage measurement

We would like to measure how Ukkora gets used — it helps us fix what does not work. We use Google Analytics and Microsoft Clarity, which store cookies in your browser. Without your consent they are not loaded.