Connect Taskonio to the agent you already use.

Manage tasks, workspaces, and sprints through any compatible MCP client.

Quick setup

Pick your client and connect.

Connect to Taskonio's production MCP endpoint, then sign in and choose the organization your agent can access. Most clients guide you through authorization automatically.

Connection details

Transport: Streamable HTTP
Authentication: OAuth 2.1 with PKCE

Claude Code

Run the command, then sign in to Taskonio and approve the requested access.

claude mcp add taskonio --transport http https://api.taskonio.com/v1/mcp

Claude Desktop

Add the server to your Claude Desktop configuration, restart the app, then authorize when prompted.

macOS
~/Library/Application Support/Claude/claude_desktop_config.json

Windows
%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "taskonio": {
      "type": "http",
      "url": "https://api.taskonio.com/v1/mcp"
    }
  }
}

Cursor

Open Settings, then MCP Servers.
Select Add Server.
Set the name to taskonio, the type to http, and use the endpoint below.
Save the server and authorize when prompted.

https://api.taskonio.com/v1/mcp

Windsurf

Add the server configuration to ~/.windsurf/mcp.json.

{
  "mcpServers": {
    "taskonio": {
      "type": "http",
      "url": "https://api.taskonio.com/v1/mcp"
    }
  }
}

Other MCP clients

Use Streamable HTTP, connect to the endpoint below, and complete the OAuth flow opened by your client.

https://api.taskonio.com/v1/mcp

Authentication

Secure access, handled by your client.

Taskonio uses OAuth 2.1 with PKCE. You choose the organization the client may access.

Connect
Your client initiates a connection to the MCP endpoint.
Sign in
Taskonio opens so you can authenticate.
Choose access
Select the organization you want to authorize.
Continue working
The client receives access and handles token refresh.

OAuth discovery endpoints

GET https://api.taskonio.com/.well-known/oauth-authorization-server
GET https://api.taskonio.com/.well-known/oauth-protected-resource

Access token: 1 hour
Refresh token: 30 days

Available tools

Give your agent useful access to real work.

The MCP exposes focused tools for task operations, workspace context, organization data, planning, and Taskonio AI.

Tasks

create_task: Create a new task in a workspace
get_task: Get task details with comments and labels
update_task: Update status, assignee, priority, and other properties
delete_task: Permanently delete a task
search_tasks: List and search tasks with pagination
add_comment: Add a comment to a task
get_subtasks: Get subtasks or tasks under an epic
resolve_task_url: Fetch task details from a Taskonio URL

Workspaces

list_workspaces: List every workspace you can access
get_workspace: Get workspace statuses, labels, and views
create_sprint: Create a new sprint
list_epics: List epics in a workspace
list_workspace_members: List members of a workspace

Organization

list_organizations: List your organizations
get_organization_members: List members in an organization
get_notifications: Get your Taskonio notifications

Planning

get_planning_session: Get the latest active planning session
create_planning_session: Start a new planning session
move_tasks_to_sprint: Assign tasks to a sprint

AI-powered

ai_suggest_description: Generate a task description from a title
ai_breakdown_task: Break a task into subtasks

Usage examples

Ask in plain language.

Once connected, use direct requests or paste a Taskonio task URL into your conversation.

> Show me all tasks in the Application workspace

> Create a bug report: "Login page crashes on Safari 17"

> What is the status of task #42?

> Break down task #48 into subtasks

> Move tasks #101, #102, and #103 to the current sprint

> Assign task #55 to me and set priority to High

> Analyse this task: https://app.taskonio.com/org123/space/abc/task/48

Troubleshooting

Common connection fixes.

"Authentication failed" or "Unauthorized"+

Make sure you are signed in to Taskonio.
Remove and add the MCP server again.
Check that your account can access the organization you selected.

"Connection refused" or timeout+

Verify that the URL is https://api.taskonio.com/v1/mcp.
Check your internet connection.
If the server is temporarily unavailable, wait a few minutes and retry.

Tools are not showing+

Restart your AI client after adding the MCP server.
Check that authorization completed successfully.
Some clients require MCP tools to be enabled in settings.

Session expired+

Sessions expire after 30 minutes of inactivity.
Your client should reconnect automatically. Restart it if it does not.

Team configuration

Share the connection with your project.

Add a .mcp.json file to the project root. Supported editors will prompt each team member to connect.

{
  "mcpServers": {
    "taskonio": {
      "type": "http",
      "url": "https://api.taskonio.com/v1/mcp"
    }
  }
}

Put Taskonio in the workflow you already use.

Create your workspace, then connect the agent that helps you plan and ship.

Start free