worksection-mcp-server

MCP (Model Context Protocol) server for Worksection — a project management platform popular in Ukraine and Eastern Europe.

This server enables AI assistants like Claude to interact with your Worksection account: manage projects, tasks, comments, members, and tags through natural language.

Features

Projects

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

Tasks

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.

Comments

worksection_get_comments — Get all comments on a task
worksection_post_comment — Post a comment to a task

Members

worksection_get_members — List all account members
worksection_add_project_members — Add members to a project

Prerequisites

Node.js 18+
A Worksection account with admin access (for the API key)

Setup

1. Get your API key

Go to Account → API → Show API key in your Worksection account.

Only the account owner has access to the admin API key.

2. Install

git clone https://github.com/YOUR_USERNAME/worksection-mcp-server.git
cd worksection-mcp-server
npm install
npm run build

3. Configure

Set environment variables:

export WORKSECTION_URL=https://yourcompany.worksection.com
export WORKSECTION_API_KEY=your_api_key_here

Or create a .env file (see .env.example).

Usage

With Claude Desktop

Add to your 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"
      }
    }
  }
}

With 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

API Rate Limits

Worksection enforces a 1 request per second rate limit. This MCP server automatically handles rate limiting — requests are queued with a minimum 1.1s interval.

Authentication

This server uses the Admin Token authentication method:

Generates MD5 hash from query parameters + API key
Provides full access to all account data
Only the account owner can generate the API key

For OAuth 2.0 support (per-user access), see the Worksection OAuth docs.

Security

API key is read from environment variables only, never hardcoded
All inputs are validated with Zod schemas
The server runs locally via stdio transport — no network exposure
Worksection API does not allow deletion of projects, tasks, comments, or members via API (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#� �w�o�r�k�s�e�c�t�i�o�n�-�m�c�p�-�s�e�r�v�e�r��

worksection-mcp-server