Skip to main content
Glama
Worksection MCP Server

Worksection MCP Server

by novgorodskii

Worksection MCP Server

npm version License: MIT Node.js

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.js

Get 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 build

Environment variables

Set these in your shell or create a .env file (see .env.example):

Variable

Description

WORKSECTION_URL

Your Worksection URL (e.g. https://yourcompany.worksection.com)

WORKSECTION_API_KEY

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.js

Make 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.js

Available Tools

The server exposes 21 tools across 5 categories.

Tool

Description

worksection_get_projects

List all projects with optional status filter

worksection_get_project

Get detailed project info

worksection_create_project

Create a new project

worksection_update_project

Update project details

worksection_archive_project

Archive a project

worksection_activate_project

Activate an archived project

worksection_get_project_folders

List project folders

Tool

Description

worksection_get_all_tasks

List all tasks across projects

worksection_get_tasks

List tasks in a specific project

worksection_get_task

Get detailed task info

worksection_create_task

Create a task (or subtask)

worksection_update_task

Update task details

worksection_complete_task

Mark task as done

worksection_reopen_task

Reopen a completed task

worksection_search_tasks

Search tasks by text, assignee, dates, etc.

Tool

Description

worksection_get_comments

Get all comments on a task

worksection_post_comment

Post a comment to a task

Tool

Description

worksection_get_members

List all account members

worksection_add_project_members

Add members to a project

Tool

Description

worksection_get_tags

List available tags/labels

worksection_set_task_tags

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 server

Project 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.md

License

MIT


Available Tools

21 tools
worksection_activate_projectActivate Worksection ProjectA
Idempotent

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 ProjectB
Idempotent

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 ProjectB
Idempotent

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 TaskB
Idempotent

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 TasksA
Read-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 CommentsA
Read-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 MembersA
Read-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 DetailsA
Read-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 FoldersA
Read-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 ProjectsA
Read-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 TagsA
Read-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 DetailsA
Read-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 TasksA
Read-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 TaskA
Idempotent

Reopen a previously completed task.

Args:

  • id_task (string, required): Task ID to reopen

Returns: Confirmation.

Inputs: id_task (required).

worksection_search_tasksSearch Worksection TasksA
Read-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 TagsB
Idempotent

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 ProjectA
Idempotent

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 TaskB
Idempotent

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

    A3.9/5.0

    Scored across 21 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count4/5

    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.

    Completeness5/5

    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

    Related MCP Servers

    • A
      license
      B
      quality
      C
      maintenance
      Enables 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.
      11
      43 npm
      1
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      Enables 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.
      47
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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 npm
      1
      MIT