Worksection MCP Server
The Worksection MCP Server lets AI assistants manage a Worksection project management account via natural language, covering projects, tasks, comments, members, and tags.
Projects: List (with status filtering), get details, create, update, archive/activate, and retrieve project folders.
Tasks: List all or project-specific tasks, get details (including subtasks and files), create tasks/subtasks, update, complete/reopen, and search by text, assignee, project, or date range.
Comments: Get comments on a task (optionally including attachments) and post new comments.
Members: List all account members (with email, name, role, and status); add members to a project.
Tags: List available tags; set tags on a task by name or ID.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Worksection MCP Server list all active tasks in the Website Redesign project"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Worksection MCP Server
MCP (Model Context Protocol) server for Worksection — a project management platform popular in Ukraine and Eastern Europe.
Lets AI assistants like Claude interact with your Worksection account through natural language: manage projects, tasks, comments, members, and tags.
Table of Contents
Related MCP server: OpenProject MCP Server
Quick Start
# 1. Install
git clone https://github.com/novgorodskii/worksection-mcp-server.git
cd worksection-mcp-server
npm install && npm run build
# 2. Configure env vars
export WORKSECTION_URL=https://yourcompany.worksection.com
export WORKSECTION_API_KEY=your_api_key_here
# 3. Run
node dist/index.jsGet your API key in Worksection: Account → API → Show API key (only the account owner has access).
Installation
Prerequisites
Node.js 18 or higher
A Worksection account with admin access
From source
git clone https://github.com/novgorodskii/worksection-mcp-server.git
cd worksection-mcp-server
npm install
npm run buildEnvironment variables
Set these in your shell or create a .env file (see .env.example):
Variable | Description |
| Your Worksection URL (e.g. |
| Admin API key from Worksection settings |
Configuration
Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"worksection": {
"command": "node",
"args": ["/path/to/worksection-mcp-server/dist/index.js"],
"env": {
"WORKSECTION_URL": "https://yourcompany.worksection.com",
"WORKSECTION_API_KEY": "your_api_key_here"
}
}
}
}Claude Code
claude mcp add worksection -- node /path/to/worksection-mcp-server/dist/index.jsMake sure WORKSECTION_URL and WORKSECTION_API_KEY are set in your shell environment.
Direct execution
WORKSECTION_URL=https://yourcompany.worksection.com \
WORKSECTION_API_KEY=your_key \
node dist/index.jsAvailable Tools
The server exposes 21 tools across 5 categories.
Tool | Description |
| List all projects with optional status filter |
| Get detailed project info |
| Create a new project |
| Update project details |
| Archive a project |
| Activate an archived project |
| List project folders |
Tool | Description |
| List all tasks across projects |
| List tasks in a specific project |
| Get detailed task info |
| Create a task (or subtask) |
| Update task details |
| Mark task as done |
| Reopen a completed task |
| Search tasks by text, assignee, dates, etc. |
Tool | Description |
| Get all comments on a task |
| Post a comment to a task |
Tool | Description |
| List all account members |
| Add members to a project |
Tool | Description |
| List available tags/labels |
| Set tags on a task |
Authentication
This server uses the Admin Token authentication method:
Generates an MD5 hash from query parameters + API key
Provides full access to all account data
Only the account owner can generate the API key
For per-user access, see the Worksection OAuth 2.0 docs.
Rate Limits
Worksection enforces a 1 request per second rate limit. This server handles it automatically — requests are queued with a minimum 1.1s interval, so you don't have to worry about hitting the limit.
Security
🔐 API key is read from environment variables only — never hardcoded
✅ All inputs validated with Zod schemas
🖥️ Runs locally via stdio transport — no network exposure
🛡️ Worksection API itself doesn't allow deletion of projects, tasks, comments, or members (safety by design)
Development
npm run dev # Watch mode (auto-recompile)
npm run build # One-time build
npm start # Run the serverProject Structure
worksection-mcp-server/
├── src/
│ ├── index.ts # Server entry point
│ ├── types.ts # TypeScript type definitions
│ ├── constants.ts # Shared constants
│ ├── services/
│ │ ├── client.ts # Worksection API client (auth + rate limit)
│ │ └── formatters.ts # Markdown formatting helpers
│ └── tools/
│ ├── projects.ts # Project management tools
│ ├── tasks.ts # Task management tools
│ ├── comments.ts # Comment tools
│ ├── members.ts # Member/team tools
│ └── tags.ts # Tag/label tools
├── package.json
├── tsconfig.json
└── README.mdLicense
Available Tools
21 toolsworksection_activate_projectActivate Worksection ProjectAIdempotent
Activate (unarchive) a previously archived Worksection project.
Args:
id_project (string, required): Project ID to activate
Returns: Confirmation of activation.
Inputs: id_project (required).
worksection_add_project_membersAdd Members to ProjectBIdempotent
Add one or more members to a Worksection project team.
Args:
id_project (string, required): Project ID
members (string, required): Comma-separated list of member email addresses
Returns: Confirmation.
Inputs: id_project (required), members (required).
worksection_archive_projectArchive Worksection ProjectBIdempotent
Archive (close) a Worksection project.
Args:
id_project (string, required): Project ID to archive
Returns: Confirmation of archival.
Inputs: id_project (required).
worksection_complete_taskComplete Worksection TaskBIdempotent
Mark a task as completed (done).
Args:
id_task (string, required): Task ID to complete
Returns: Confirmation.
Inputs: id_task (required).
worksection_create_projectCreate Worksection ProjectB
Create a new project in Worksection.
Args:
title (string, required): Project name
email_manager (string, optional): Email of the project manager
email_user_from (string, optional): Email of the project creator
text (string, optional): Project description
date_start (string, optional): Start date in YYYY-MM-DD format
date_end (string, optional): Due date in YYYY-MM-DD format
max_time (string, optional): Time estimate in hours
max_money (string, optional): Financial budget estimate
Returns: Created project data with ID.
Inputs: title (required), email_manager, email_user_from, text, +4 more.
worksection_create_taskCreate Worksection TaskA
Create a new task in a Worksection project.
Args:
id_project (string, required): Project ID where the task will be created
title (string, required): Task name
id_parent (string, optional): Parent task ID to create as a subtask
email_user_to (string, optional): Assignee email
email_user_from (string, optional): Creator email
text (string, optional): Task description
priority (string, optional): Priority 0-10 (0=lowest, 10=highest)
date_start (string, optional): Start date YYYY-MM-DD
date_end (string, optional): Due date YYYY-MM-DD
todo (string, optional): Checklist items, one per line
max_time (string, optional): Time estimate in hours
max_money (string, optional): Budget estimate
Returns: Created task data with ID.
Inputs: id_project (required), title (required), id_parent, email_user_to, +8 more.
worksection_get_all_tasksList All Worksection TasksARead-onlyIdempotent
Get all tasks across all projects in the Worksection account.
Args:
filter (string, optional): Set to "active" to get only incomplete tasks
extra (string, optional): Comma-separated extras: "text", "html", "files", "comments", "relations", "subtasks", "archive"
Returns: List of tasks with id, name, status, priority, author, assignee, project, dates, estimates, tags.
Note: This may return a large dataset. Use filter="active" or get tasks per project for better performance.
Inputs: filter, extra.
worksection_get_commentsGet Task CommentsARead-onlyIdempotent
Get all comments for a specific Worksection task.
Args:
id_task (string, required): Task ID
extra (string, optional): Set to "files" to include attached files info
Returns: List of comments with author, text, date, and optionally file attachments.
Inputs: id_task (required), extra.
worksection_get_membersList Worksection MembersARead-onlyIdempotent
Get all members (users) of the Worksection account.
Returns: List of members with id, email, name, online status, and role.
Inputs: no named parameters.
worksection_get_projectGet Worksection Project DetailsARead-onlyIdempotent
Get detailed information about a specific Worksection project by its ID.
Args:
id_project (string, required): The project ID
extra (string, optional): Additional data — comma-separated: "text", "html", "options", "users"
Returns: Project details including name, status, dates, team members, settings.
Inputs: id_project (required), extra.
worksection_get_project_foldersList Worksection Project FoldersARead-onlyIdempotent
Get all project folders (groups) in the Worksection account.
Returns: List of folders with id and name.
Inputs: no named parameters.
worksection_get_projectsList Worksection ProjectsARead-onlyIdempotent
List all projects in the Worksection account with optional filtering by status.
Args:
filter (string, optional): Filter by status — "active", "pending", or "archived"
extra (string, optional): Additional data to include — comma-separated: "text", "html", "options", "users"
Returns: List of projects with id, name, status, folder, author, manager, dates, estimates, tags.
Inputs: filter, extra.
worksection_get_tagsGet Worksection TagsARead-onlyIdempotent
Get all available tags (labels/statuses) for projects or tasks.
Args:
type (string, optional): "project" for project tags, "task" for task tags. Defaults to both.
Returns: List of tags with id and name.
Inputs: type.
worksection_get_taskGet Worksection Task DetailsARead-onlyIdempotent
Get detailed information about a specific task.
Args:
id_task (string, required): Task ID
extra (string, optional): Comma-separated: "text", "html", "files", "comments", "relations", "subtasks"
Returns: Full task details including description, subtasks, files, relations.
Inputs: id_task (required), extra.
worksection_get_tasksList Project TasksARead-onlyIdempotent
Get all tasks for a specific Worksection project.
Args:
id_project (string, required): Project ID
filter (string, optional): Set to "active" for incomplete tasks only
extra (string, optional): Comma-separated: "text", "html", "files", "comments", "relations", "subtasks", "subscribers"
Returns: List of tasks in the project with full details.
Inputs: id_project (required), filter, extra.
worksection_post_commentPost Comment to TaskA
Add a comment to a Worksection task.
Args:
id_task (string, required): Task ID to comment on
text (string, required): Comment text content
todo (string, optional): Checklist items, one per line (creates checkboxes in the comment)
email_user_from (string, optional): Email of the comment author (defaults to API key owner)
Returns: Created comment data.
Inputs: id_task (required), text (required), todo, email_user_from.
worksection_reopen_taskReopen Worksection TaskAIdempotent
Reopen a previously completed task.
Args:
id_task (string, required): Task ID to reopen
Returns: Confirmation.
Inputs: id_task (required).
worksection_search_tasksSearch Worksection TasksARead-onlyIdempotent
Search for tasks across the account using various criteria.
Args:
filter (string, optional): "active" for incomplete only
id_project (string, optional): Limit to specific project
text (string, optional): Search in task title and description
email_user_to (string, optional): Filter by assignee email
date_start (string, optional): Tasks starting from YYYY-MM-DD
date_end (string, optional): Tasks due before YYYY-MM-DD
extra (string, optional): Additional data to include
Returns: List of matching tasks.
Inputs: filter, id_project, text, email_user_to, +3 more.
worksection_set_task_tagsSet Task TagsBIdempotent
Set tags (labels/statuses) on a Worksection task.
Args:
id_task (string, required): Task ID
tags (string, required): Comma-separated tag names or IDs
Returns: Confirmation.
Inputs: id_task (required), tags (required).
worksection_update_projectUpdate Worksection ProjectAIdempotent
Update an existing Worksection project. Only provided fields will be updated.
Args:
id_project (string, required): Project ID
title (string, optional): New project name
email_manager (string, optional): New project manager email
text (string, optional): New description
date_start (string, optional): New start date YYYY-MM-DD
date_end (string, optional): New due date YYYY-MM-DD
Returns: Updated project data.
Inputs: id_project (required), title, email_manager, text, +2 more.
worksection_update_taskUpdate Worksection TaskBIdempotent
Update an existing task. Only provided fields will be changed.
Args:
id_task (string, required): Task ID to update
title (string, optional): New task name
email_user_to (string, optional): New assignee email
text (string, optional): New description
priority (string, optional): New priority 0-10
date_start (string, optional): New start date YYYY-MM-DD
date_end (string, optional): New due date YYYY-MM-DD
max_time (string, optional): New time estimate
max_money (string, optional): New budget
Returns: Updated task data.
Inputs: id_task (required), title, email_user_to, text, +5 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 21 tools
Every tool has a clearly distinct purpose with no ambiguity. Each tool name specifies a unique action on a specific resource (e.g., worksection_create_project vs worksection_update_project, worksection_get_task vs worksection_get_tasks), and the descriptions reinforce this separation. There are no overlapping or redundant tools.
All tool names follow a consistent verb_noun pattern with the 'worksection_' prefix, using snake_case throughout. The verbs are clear and appropriate (e.g., create, get, update, add, archive), and the nouns consistently refer to resources like project, task, members, comments, or tags. There are no deviations in naming conventions.
With 21 tools, the count is slightly high but reasonable for a project management domain like Worksection, which requires comprehensive operations for projects, tasks, members, comments, and tags. It covers many workflows without being excessive, though it might feel heavy compared to simpler servers. The tools are well-scoped, with each serving a distinct function.
The tool set provides complete CRUD/lifecycle coverage for the Worksection domain. It includes creation, retrieval, updating, and deletion (via archive/complete actions) for projects and tasks, along with operations for members, comments, tags, and search. There are no obvious gaps; agents can manage the full lifecycle of resources without dead ends.
Related MCP Connectors
Manage tasks, projects, roadmaps, files, meetings, and team workflows with AI tools.
Manage Redbooth tasks, task lists, comments, tags and files from Claude and other AI assistants.
Create and manage MeisterTask projects, tasks, and notes from your AI assistant.
Manage Avaza projects, tasks, timesheets, expenses, invoices, and scheduling from AI assistants.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceConnects AI assistants to Motion for comprehensive task and project management, including creating/updating tasks, managing projects, handling workspaces, comments, and recurring tasks with smart rate limiting.2MIT
- AlicenseBqualityCmaintenanceEnables AI assistants to manage OpenProject work packages, projects, and time tracking. It provides comprehensive tools for creating, updating, and querying tasks and project metadata through the OpenProject API.1143 npm1MIT
- AlicenseBqualityCmaintenanceEnables AI assistants to interact with ProjectHub for comprehensive project management through natural language. It provides 25 tools to manage tasks, workspaces, time tracking, notes, and discussions via the ProjectHub API.47MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to manage Todocko application data, including tasks, projects, worklogs, and attachments. It supports comprehensive project management operations such as tracking activity, managing Kanban boards, and handling shared project synchronization.253 npm1MIT