TaskLabs documentation

Self-hosted task and calendar management for teams. This guide covers running the product, configuring it, and automating it with the MCP endpoint.

What is TaskLabs?

TaskLabs is a multi-tenant task and calendar manager built to run on infrastructure you control. Teams use it for Kanban boards, a shared calendar, realtime updates, and reminders that reach people on Telegram.

• Organize work visually with drag-and-drop Kanban boards.
• Plan on a shared calendar with recurring events.
• Work as a team in workspaces with invitations and roles.
• Get deadline reminders through Telegram.
• Automate it with the MCP endpoint and workspace-scoped API keys.

Architecture

TaskLabs is a pnpm monorepo with two packages. The frontend is a Next.js 16 application; the backend is a self-hosted Convex deployment backed by Postgres. Authentication uses Convex Auth. The whole stack runs under Docker Compose.

• frontend/ — the Next.js app users interact with.
• backend/ — the Convex project: schema, functions, services, and HTTP actions.
• Postgres — the single storage engine for the Convex backend.
• Docker Compose — Postgres, the Convex backend, the dashboard, the frontend, and a daily backup scheduler.

Every Convex query and mutation resolves the caller and scopes data to a workspace the caller belongs to, so multi-tenancy is enforced at the backend boundary.

What it does

• Kanban boards with ordered stages and stable column widths.
• A shared calendar with daily, weekly, and monthly recurrence.
• Realtime updates across members — no refresh required.
• Labels, assignees, workspace search, and a notification center.
• Telegram reminders via encrypted token storage and webhook capture.
• Automation through the MCP endpoint — a stateless JSON-RPC interface protected by API keys.

Next steps