Task Manager ยท AI assistant connection

Projects & tasks for AI agents

Connect Cursor, Claude Desktop, or any MCP client to Task Manager โ€” projects, issues, time logs, burndown charts, and worklog reports through one secure HTTPS endpoint.

35MCP tools
OAuthBrowser sign-in
HTTPSStreamable HTTP

Live endpoints

MCP https://mcp.taskmanager.klizos.com/mcp POST/GET
Health https://mcp.taskmanager.klizos.com/healthz GET
Issuer https://mcp.taskmanager.klizos.com

Cursor config

{
  "mcpServers": {
    "taskmanager": {
      "url": "https://mcp.taskmanager.klizos.com/mcp"
    }
  }
}

How it works

Keep using your favourite AI app โ€” Task Manager supplies live project and task data behind the scenes.

Step 1

Connect once with your Task Manager email and password โ€” the same credentials as the Task Manager web app.

Step 2

Ask in plain language: my tasks, project status, team workload, or a member's worklog for last month.

Step 3

The assistant fetches only what your role allows and returns a readable answer you can act on.

What you can do

Live data from your organisation โ€” no need to memorise API names or navigate multiple screens.

Sign in securely

Connect with your Task Manager account โ€” the same email and password you use in the web app. Sign in once in the browser; the assistant only accesses projects and data your role already allows.

Projects & tasks

List projects, starred and recent work, ongoing initiatives, task distribution, and issue breakdowns by status or type โ€” without clicking through multiple dashboard screens.

Issues & assignments

Fetch my tasks, issues by project, issue details by ID or key, review lists, team workload, statuses, and types โ€” ideal for stand-ups and sprint planning in chat.

Time logs & productivity

Pull member productivity, time-log metrics, team rankings by spent time, burndown charts, and per-member worklog reports for any date range.

Analytics & reports

Get productivity analytics, waterfall burndown for a project, org-wide worklog reports, and member-level project breakdowns โ€” grounded in live Task Manager data.

Team & roles

Look up users, project members, member efficiency scores, and role information โ€” scoped to the same permissions as the Task Manager web application.

Example questions

Phrase them your own way โ€” the assistant understands natural language.

35 MCP tools

Grouped by domain โ€” all callable from your AI client after sign-in.

Auth โ€” login, refresh, user context
Projects โ€” list, starred, ongoing, members, distribution
Issues โ€” my tasks, by project, details, review, workload
Analytics โ€” time logs, productivity, burndown, metrics
Reports โ€” worklog, member project report
Team โ€” users, roles, member efficiency

Connect to your app

Same Task Manager login for every app below. Pick your tool and follow the steps.

Most clients use one connection URL and a short sign-in in the browser. You do not paste passwords into the AI app โ€” OAuth handles the session securely.

Shared connection (all supported apps)

Add this to your client's MCP config, or use "Add MCP server" with the URL below.

Server URL https://mcp.taskmanager.klizos.com/mcp
{
  "mcpServers": {
    "taskmanager": {
      "url": "https://mcp.taskmanager.klizos.com/mcp"
    }
  }
}
Cursor Recommended

Config file

  • Windows: %USERPROFILE%\.cursor\mcp.json
  • macOS / Linux: ~/.cursor/mcp.json
  • Or: .cursor/mcp.json in your project folder
  1. Open Cursor โ†’ Settings โ†’ MCP (or edit mcp.json directly).
  2. Add the taskmanager server using the connection block below.
  3. Save and restart Cursor if the server does not appear.
  4. Click Connect next to taskmanager and sign in with your Task Manager credentials.
  5. When the browser confirms success, return to Cursor and ask a task or project question.
Claude Desktop OAuth supported

Config file

  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  1. Quit Claude Desktop, then open the config file above.
  2. Merge the mcpServers block from below into the top-level object.
  3. Restart Claude Desktop and confirm taskmanager appears under MCP.
  4. Authorize when prompted and complete Task Manager sign-in in the browser.
VS Code (GitHub Copilot & MCP) VS Code 1.102+

Config file

  • Workspace: .vscode/mcp.json
  • User profile: MCP section in VS Code Settings
  1. Enable GitHub Copilot and MCP support.
  2. Add .vscode/mcp.json or open MCP user configuration.
  3. Paste the mcpServers block below and reload the window.
  4. Connect taskmanager from the Copilot / agent panel and sign in via browser.
Other MCP clients HTTP + OAuth

Universal pattern

  • Any MCP settings screen that accepts a remote HTTPS server URL
  1. Your client must support remote MCP over HTTPS (Streamable HTTP) and OAuth.
  2. Add one server named taskmanager with the URL below.
  3. Trigger Connect / Authorize and complete Task Manager login in the browser.
  4. For stdio-only clients, use the local npm package with TASKMANAGER_ACCESS_TOKEN instead.

FAQ

Do I need a separate account?

No. Use the same Task Manager email you already have. If you cannot log in to the web app, you cannot connect here either.

Does this replace the Task Manager website?

No. It adds convenience inside AI tools. For boards, drag-and-drop, and time entry, keep using the web app.

Who can see what?

Exactly what your Task Manager role allows โ€” project members see their projects, managers see broader scope, same as the website.

Can I run it locally?

Yes. Clone the repo, set BACKEND_BASE_URL in .env, run npm run dev:http (port 3120) or npm run dev for stdio. See the README for Cursor mcp.json examples.

Where is the API documentation?

See docs/API_REFERENCE.md in the repository for the full MCP tool โ†’ route mapping.

Ready to connect to your app?

Choose your app above, sign in once, and start asking project questions in plain language.

View setup steps