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

Tags

• worksection_get_tags — List available tags/labels
• worksection_set_task_tags — Set tags on a task

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� � �