@2digits/tlo-mcp
v0.1.6
Published
MCP (Model Context Protocol) server for TeamLeader Orbit (TLO) - project management and time tracking.
Readme
@2digits/tlo-mcp
MCP (Model Context Protocol) server for TeamLeader Orbit (TLO) - project management and time tracking.
Installation
pnpm add @2digits/tlo-mcpUsage
As MCP Server
TLO_COOKIE="your-session-cookie" npx @2digits/tlo-mcpConfiguration
Set the TLO_COOKIE environment variable to your TeamLeader Orbit session cookie.
Data Model
FOLDER (workspace, e.g., "2DIGITS | Projects")
└── PROJECT (e.g., "I amsterdam | doorontwikkeling")
├── TASK (work items with budget/workload)
│ └── ACTIVITY (time entries)
└── BOARD (kanban)
└── BOARDLIST (column)
└── TODO (card)Key IDs
folderId- Workspace containing projectsprojectId- Project within a foldertaskId- Work item within projecttodoId- Kanban cardcontactId- User identifier
Available Tools
Projects
| Tool | Description |
| --------------------- | --------------------------------------------------- |
| get_projects | List all projects with client, owner, dates, budget |
| get_project_details | Get single project with billing rates |
| get_tasks | Get tasks within a project |
| get_tasks_for_user | Get tasks assigned to a user |
| set_task_state | Change task state (DRAFT/OPEN/COMPLETED/CLOSED) |
Time Tracking
| Tool | Description |
| --------------------- | ------------------------------- |
| get_week_activities | Get all time entries for a week |
| create_activity | Log time against project/task |
| update_activity | Modify existing time entry |
| delete_activity | Remove time entry |
Kanban
| Tool | Description |
| ----------------- | -------------------------------------- |
| get_todo_detail | Get kanban card with columns and links |
| move_todo | Move card between columns |
Messages
| Tool | Description |
| -------------- | ---------------------------------- |
| get_messages | Get comments on project/board/todo |
| post_message | Add comment to project/board/todo |
Common Workflows
View someone's week
get_week_activities(date: "2025-01-20", contactId: "1699127")Log time
1. get_projects() → find folderId
2. get_tasks(projectId) → optionally find taskId
3. create_activity(folderId, startDate, durationMinutes, contactId)Move kanban card
1. get_todo_detail(todoId) → get boardId and BOARDLISTS
2. move_todo(id, boardId, boardListId, sortIndex: 0)License
MIT
