Development Guide

Welcome to the ClickUp MCP Server development guide! This section provides comprehensive information for developers who want to understand, modify, or contribute to the project.

Getting Started

If you're new to the project, we recommend starting with these sections:

• Development Workflow - How to set up and contribute to the project

Development Guidelines

Centralized standards and best practices for building and maintaining this project:

• Development Guidelines home
• Requirements
• Coding Styles and Rules
• Testing Strategy
• MCP Tool Development Guidelines

Quick links (Architecture deep dives)

• Centralized Error Handling
• Models — DTO vs Domain vs MCP I/O
• Software Architecture Overview

Quick links (Guidelines)

• MCP Tool Development Guidelines

Going Deeper

Once you're familiar with the basics, you can explore:

• Software Architecture - Overview of the project architecture
• CI/CD Workflows - Continuous Integration and Deployment processes

How to preview docs locally

From the repo root, run your normal docs command (pnpm/yarn/npm) to start Docusaurus and preview these pages. If you use pnpm:

pnpm --filter docs dev

Contributing

We welcome contributions! Before submitting code, please make sure you've read the Contributing Guide as well as the detailed development sections in this guide.