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
| Tool | Description |
|---|---|
list_workspaces | List all workspaces (teams) accessible with your token |
list_tasks | List tasks — filter by workspace, assignee, or status |
get_task | Get a specific task by ID |
create_task | Create a new task in a workspace |
update_task | Update title, description, deadline, or assignee |
complete_task | Mark a task as completed |
uncomplete_task | Reopen 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 variable | Required | Description |
|---|---|---|
UKKORA_TOKEN | ✓ | Integration token from Settings → API Tokens |
UKKORA_BASE_URL | — | Override API base URL (default: <SiteUrl />) |