[{"_1":2,"_396":-5,"_397":-5},"loaderData",{"_3":4,"_22":23,"_24":25,"_279":280},"root",{"_5":6,"_7":8},"toasts",[],"visitor",{"_9":10,"_11":12},"viewportWidth",1280,"visitorSession",{"_13":14,"_16":17,"_18":-5,"_19":20,"_21":-5},"attributes",[15],"bot","id",11143072,"membership","referenceId","01989bb3-6f03-717c-8403-57f67b03b520","userAccount","routes/_public/_layout",{},"routes/_public/mcp/servers/~namespace/~slug/_pages/_layout",{"_26":27,"_82":-5,"_83":40,"_29":84,"_195":196,"_277":278},"availableLocales",[28,40,47,54,61,68,75],{"_29":30,"_33":37,"_38":39},"mcpServer",{"_31":32,"_33":34,"_35":36},"description","Dieser Server integriert KI-Assistenten mit ClickUp-Arbeitsbereichen und ermöglicht die Verwaltung von Aufgaben, Teams, Listen und Boards durch einen sicheren OAuth2-Authentifizierungsprozess.","name","ClickUp MCP-Server","readme","# ClickUp MCP-Server\n\n[![Schmiedeabzeichen](https://smithery.ai/badge/@Nazruden/clickup-mcp-server)](https://smithery.ai/server/@Nazruden/clickup-mcp-server) [![npm-Version](https://badge.fury.io/js/%40nazruden%2Fclickup-server.svg)](https://badge.fury.io/js/%40nazruden%2Fclickup-server) [![Lizenz: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nEine Model Context Protocol-Serverimplementierung für die ClickUp-Integration, die es KI-Assistenten ermöglicht, mit ClickUp-Arbeitsbereichen zu interagieren.\n\nDieser Server wird gemäß der MCP-Spezifikation über **Stdio** ausgeführt, wenn er von einem MCP-Client aufgerufen wird.\n\n## Schnellstart\n\nDieser Server verwendet Ihr **persönliches ClickUp-API-Token** zur Authentifizierung.\n\n1. **Generieren Sie ein persönliches API-Token:** Navigieren Sie in Ihren ClickUp-Einstellungen zu „Meine Einstellungen“ > „Apps“ und generieren Sie ein Token.\n2. **Konfigurieren Sie Ihren MCP-Client (z. B. Claude für Desktop):** Legen Sie die erforderliche Umgebungsvariable fest, wenn Sie den Server für Ihren Client konfigurieren.\n\nBeispielkonfigurationsausschnitt für einen MCP-Client:\n\n```json\n{\n \"mcpServers\": {\n \"clickup\": {\n \"command\": \"npx\",\n \"args\": [\"@nazruden/clickup-server\"],\n \"env\": {\n \"CLICKUP_PERSONAL_TOKEN\": \"your_personal_api_token_here\"\n }\n }\n }\n}\n```\n\n3. **Starten Sie Ihren MCP-Client neu.**\n\nDer Server wird bei Bedarf automatisch vom MCP-Client heruntergeladen und gestartet.\n\n### Installation über Smithery\n\nSo installieren Sie ClickUp MCP Server für Claude Desktop automatisch über [Smithery](https://smithery.ai/server/@Nazruden/clickup-mcp-server) :\n\n```bash\nnpx -y @smithery/cli install @Nazruden/clickup-mcp-server --client claude\n```\n\n## Umgebungsvariablen\n\n### Erforderlich\n\n* `CLICKUP_PERSONAL_TOKEN` : Ihr persönliches ClickUp-API-Token. Dies ist für die Authentifizierung des Servers mit der ClickUp-API erforderlich.\n\n### Optional\n\n* `LOG_LEVEL` : Protokollierungsebene für den Server. Unterstützt `error` , `warn` , `info` und `debug` . Standardmäßig `info` .\n* `ENCRYPTION_KEY` : Ein persistenter, 32 Byte langer, hexadezimal kodierter Schlüssel. Das Konfigurationssystem ( `src/config/app.config.ts` ) lädt oder generiert diesen Schlüssel, und `src/security.ts` enthält Verschlüsselungs-/Entschlüsselungsfunktionen. Dieser Mechanismus wird derzeit jedoch nicht zur Verschlüsselung des `CLICKUP_PERSONAL_TOKEN` im Authentifizierungsablauf des persönlichen API-Tokens des `ClickUpService`**verwendet** .\n* `PORT` : Server-Port. Dieser wird vom Standard-MCP-Servermodus von Stdio **nicht verwendet,** kann aber relevant sein, wenn ein HTTP-Transport oder zusätzliche HTTP-Funktionen (wie ein separater Integritätsprüfungsendpunkt) explizit hinzugefügt wurden. Der Standardwert in der Konfiguration ist `3000` wenn er gelesen wird.\n\n## Verfügbare Tools\n\nDie folgenden MCP-Tools sind derzeit implementiert:\n\n### Aufgabenverwaltung\n\n* `clickup_create_task` : Erstellen Sie eine neue Aufgabe in einer ClickUp-Liste.\n * Erforderlich: `list_id` , `name` .\n * Optional: `description` , `status` , `priority` , `assignees` , `due_date` , `time_estimate` , `tags` .\n* `clickup_update_task` : Aktualisieren Sie die Eigenschaften einer vorhandenen Aufgabe.\n * Erfordert: `task_id` .\n * Optional: Alle beschreibbaren `ClickUpTask` Eigenschaften.\n\n### Team- und Listenverwaltung\n\n* `clickup_get_teams` : Ruft alle zugänglichen Teams ab (Arbeitsbereiche in ClickUp API v2).\n* `clickup_get_lists` : Ruft alle Listen in einem bestimmten Ordner ab.\n * Erfordert: `folder_id` .\n\n### Vorstandsmanagement\n\n* `clickup_create_board` : Erstellen Sie ein neues Board in einem ClickUp-Bereich.\n * Erfordert: `space_id` , `name` .\n\n### Raummanagement\n\n* `clickup_get_spaces` : Ruft alle Spaces für einen bestimmten Arbeitsbereich (Team) ab.\n * Erforderlich: `team_id` (Workspace-ID).\n * Optional: `archived` (Boolesch, standardmäßig „ `false` ).\n* `clickup_create_space` : Erstellt einen neuen Bereich innerhalb eines Arbeitsbereichs.\n * Erforderlich: `team_id` (Arbeitsbereichs-ID), `name` .\n * Optional: `multiple_assignees` (Boolesch), `features` (Objekt mit Feature-Flags wie `due_dates` , `time_tracking` usw.).\n* `clickup_get_space` : Ruft Details für einen bestimmten Space ab.\n * Erfordert: `space_id` .\n* `clickup_update_space` : Aktualisiert einen vorhandenen Space.\n * Erfordert: `space_id` .\n * Optional: `name` , `color` , `private` , `admin_can_manage` , `archived` , `features` .\n* `clickup_delete_space` : Löscht einen Bereich.\n * Erfordert: `space_id` .\n\n### Ordnerverwaltung\n\n* `clickup_get_folders` : Ruft alle Ordner innerhalb eines bestimmten Bereichs ab.\n * Erfordert: `space_id` .\n * Optional: `archived` (Boolesch, standardmäßig „ `false` ).\n* `clickup_create_folder` : Erstellt einen neuen Ordner innerhalb eines Space.\n * Erfordert: `space_id` , `name` .\n* `clickup_get_folder` : Ruft Details für einen bestimmten Ordner ab.\n * Erfordert: `folder_id` .\n* `clickup_update_folder` : Aktualisiert einen vorhandenen Ordner.\n * Erfordert: `folder_id` , `name` .\n* `clickup_delete_folder` : Löscht einen Ordner.\n * Erfordert: `folder_id` .\n\n### Benutzerdefinierte Feldverwaltung\n\n* `clickup_get_custom_fields` : Ruft alle zugänglichen benutzerdefinierten Felder für eine bestimmte Liste ab.\n * Erforderlich: `list_id` .\n* `clickup_set_task_custom_field_value` : Legt den Wert eines benutzerdefinierten Felds für eine bestimmte Aufgabe fest.\n * Erfordert: `task_id` , `field_id` , `value` .\n * Optional: `value_options` (Objekt, z. B. `{ \"time\": true }` für Datumsfelder).\n* `clickup_remove_task_custom_field_value` : Entfernt/löscht den Wert eines benutzerdefinierten Felds aus einer bestimmten Aufgabe.\n * Erforderlich: `task_id` , `field_id` .\n\n### Dokumentenverwaltung\n\n**Hinweis:** Die ClickUp-API für Dokumente (insbesondere Version 2, wobei einige Vorgänge jetzt Version 3 verwenden) weist Einschränkungen auf. Inhalte werden hauptsächlich als Markdown verarbeitet. Erweiterte Formatierungen oder komplexe Einbettungen werden möglicherweise nicht vollständig unterstützt. Das direkte Löschen von Dokumenten über die API wird derzeit vom ClickUp-V3-/docs-Endpunkt nicht unterstützt. Verwalten Sie den Dokumentenlebenszyklus durch Archivierung oder Seitenbearbeitung.\n\n* `clickup_search_docs` : Sucht nach Dokumenten innerhalb eines Arbeitsbereichs (Teams).\n * Erfordert: `workspace_id` .\n * Optional: `query` (Zeichenfolge), `include_archived` (Boolesch).\n* `clickup_create_doc` : Erstellt ein neues Dokument.\n * Erforderlich: `workspace_id` , `name` .\n * Optional: `parent` (Objekt mit `id` und `type` ), `visibility` (Zeichenfolge: „privat“, „Arbeitsbereich“, „öffentlich“), `create_page` (Boolesch).\n* `clickup_get_doc_pages` : Ruft die Liste der Seiten innerhalb eines bestimmten Dokuments ab.\n * Erfordert: `doc_id` .\n* `clickup_create_doc_page` : Erstellt eine neue Seite innerhalb eines bestimmten Dokuments.\n * Erforderlich: `workspace_id` , `doc_id` , `name` (Seitentitel).\n * Optional: `content` (Markdown), `orderindex` (Zahl, obwohl die v3-API diese möglicherweise nicht verwendet), `parent_page_id` (Zeichenfolge), `sub_title` (Zeichenfolge), `content_format` (Zeichenfolge).\n* `clickup_get_doc_page_content` : Ruft den Inhalt (Markdown) einer bestimmten Dokumentseite ab.\n * Erfordert: `workspace_id` , `doc_id` , `page_id` .\n * Optional: `content_format` (Zeichenfolge).\n* `clickup_edit_doc_page_content` : Aktualisiert den Inhalt und/oder Titel einer bestimmten Dokumentseite.\n * Erfordert: `workspace_id` , `doc_id` , `page_id` , `content` (Markdown).\n * Optional: `title` (Zeichenfolge, wird API-Name zugeordnet), `sub_title` (Zeichenfolge), `content_edit_mode` (Zeichenfolge: „Ersetzen“, „Anhängen“, „Voranstellen“), `content_format` (Zeichenfolge).\n\n### Ansichtsverwaltung\n\n* `clickup_get_views` : Ruft alle Ansichten für eine bestimmte übergeordnete Ressource (Team, Bereich, Ordner oder Liste) ab.\n * Erforderlich: `parent_id` (ID der übergeordneten Ressource), `parent_type` (Zeichenfolge: „Team“, „Bereich“, „Ordner“ oder „Liste“).\n* `clickup_create_view` : Erstellt eine neue Ansicht innerhalb eines Teams, Bereichs, Ordners oder einer Liste.\n * Erfordert: `parent_id` , `parent_type` , `name` (Zeichenfolge: Name der neuen Ansicht), `type` (Zeichenfolge: Typ der Ansicht, z. B. „Liste“, „Board“, „Kalender“, „Gantt“).\n * Optional: `grouping` , `divide` , `sorting` , `filters` , `columns` , `team_sidebar` , `settings` (Objekte, die Ansichtskonfigurationen definieren).\n* `clickup_get_view_details` : Ruft Details für eine bestimmte Ansicht ab.\n * Erfordert: `view_id` .\n* `clickup_update_view` : Aktualisiert eine vorhandene Ansicht.\n * Erfordert: `view_id` .\n * Optional: `name` (Zeichenfolge), `grouping` , `divide` , `sorting` , `filters` , `columns` , `team_sidebar` , `settings` .\n* `clickup_delete_view` : Löscht eine Ansicht.\n * Erfordert: `view_id` .\n* `clickup_get_view_tasks` : Ruft Aufgaben ab, die zu einer bestimmten Ansicht gehören.\n * Erfordert: `view_id` .\n * Optional: `page` (Nummer: 0-indizierte Seitennummer für die Paginierung).\n\n## Entwicklung\n\n1. Klonen Sie das Repository:\n\n ```bash\n git clone \n cd clickup-mcp-server\n ```\n\n2. Installieren Sie Abhängigkeiten:\n\n ```bash\n npm install\n ```\n\n3. Erstellen Sie eine `.env` Datei im Stammverzeichnis und fügen Sie Ihr `CLICKUP_PERSONAL_TOKEN` hinzu:\n\n ```env\n CLICKUP_PERSONAL_TOKEN=your_actual_personal_api_token_here\n LOG_LEVEL=debug\n ```\n\n4. Starten Sie im Entwicklungsmodus (Stdio): Der Server wartet auf MCP-Nachrichten auf stdin/stdout.\n\n ```bash\n npm run dev\n ```\n\n Dies verwendet `ts-node-dev` um `src/index.ts` auszuführen.\n\n5. Für die Produktion erstellen:\n\n ```bash\n npm run build\n ```\n\n Dadurch wird TypeScript in `dist/` kompiliert.\n\n6. Führen Sie Tests durch:\n\n ```bash\n npm test\n ```\n\n Dadurch werden Jest-Unit-Tests ausgeführt, die sich in `src/__tests__` befinden. Stellen Sie sicher, dass Sie über eine `.env.test` Datei verfügen (siehe `src/__tests__/setup.ts` ).\n\n### Testen mit MCP Inspector\n\nSie können den Server lokal mit dem MCP Inspector testen:\n\n1. Stellen Sie sicher, dass Ihr `CLICKUP_PERSONAL_TOKEN` verfügbar ist. Sie können entweder:\n\n * Legen Sie es in Ihrer Shell-Umgebung fest, bevor Sie den Inspector ausführen.\n * Legen Sie es in der MCP Inspector-Benutzeroberfläche fest, wenn diese eine Option für Serverumgebungsvariablen bietet.\n * Haben Sie es in Ihrer lokalen `.env` Datei (da `src/index.ts``dotenv` lädt).\n\n2. Führen Sie den Inspector mit dem Server aus:\n\n ```bash\n npx @modelcontextprotocol/inspector node --loader ts-node/esm src/index.ts\n ```\n\n Die Inspector-Benutzeroberfläche sollte gestartet werden, sodass Sie eine Verbindung zum Server herstellen und seine Tools aufrufen können.\n\n## Sicherheit\n\n* Die Authentifizierung erfolgt mit Ihrem persönlichen ClickUp-API-Token. **Bewahren Sie dieses Token sicher und vertraulich auf.** Behandeln Sie es wie ein Passwort.\n* Der Server erwartet, dass das `CLICKUP_PERSONAL_TOKEN` über eine Umgebungsvariable vom nutzenden MCP-Client oder der Entwicklungsumgebung bereitgestellt wird.\n* Das Konfigurationssystem enthält eine Logik für einen `ENCRYPTION_KEY` und `src/security.ts` verfügt über Verschlüsselungsfunktionen, die jedoch **derzeit** vom `ClickUpService` nicht auf das Personal API Token angewendet werden.\n* Standardmäßig werden mit `LOG_LEVEL=info` keine sensiblen Daten (wie das Token selbst) protokolliert. Auf Debug-Ebene werden möglicherweise mehr Details protokolliert.\n* Die Ratenbegrenzung für ClickUp-API-Aufrufe wird durch die Protokollierung der verbleibenden Anfragen gehandhabt (siehe `ClickUpService` ).\n\n## Fehlerbehebung\n\n### Häufige Probleme\n\n1. **Authentifizierungsfehler (401 von ClickUp API)**\n\n * Überprüfen Sie, ob Ihre Umgebungsvariable `CLICKUP_PERSONAL_TOKEN` richtig eingestellt ist und vom Serverprozess darauf zugegriffen werden kann.\n * Stellen Sie sicher, dass das Token gültig ist und in Ihren ClickUp-Einstellungen nicht widerrufen wurde.\n * Überprüfen Sie die Serverprotokolle auf Nachrichten von `ClickUpService` bezüglich der Authentifizierung.\n\n2. **Ratenbegrenzung durch ClickUp-API**\n\n * Der Server protokolliert Ratenbegrenzungsinformationen aus ClickUp-API-Antworten.\n * Wenn Ratenbegrenzungen häufig erreicht werden, deutet dies auf eine hohe Auslastung hin. Der Server selbst implementiert keine Warteschlangen oder komplexe Backoffs, die über das hinausgehen, was `axios` standardmäßig tun könnte.\n\n3. **Server startet nicht / Verbindungsprobleme mit MCP Inspector**\n\n * Stellen Sie sicher, dass `CLICKUP_PERSONAL_TOKEN` festgelegt ist.\n * Wenn Sie `npm run dev` verwenden, suchen Sie in der Konsole nach TypeScript- oder `ts-node-dev` Fehlern.\n * Wenn Sie MCP Inspector mit `node --loader ts-node/esm src/index.ts` verwenden, stellen Sie sicher, dass `ts-node` und Projektabhängigkeiten korrekt installiert sind.\n * Suchen Sie nach Konsolenfehlern von `src/index.ts` oder `ClickUpService` .\n\n### Abrufen von Serverprotokollen\n\n* Bei der Ausführung über `npm run dev` oder `npm start` werden die Protokolle an die Konsole gesendet.\n* Wenn die Anwendung von einem MCP-Client (wie Claude für Desktop) ausgeführt wird, werden die Protokolle in der Regel von diesem Client verwaltet. Für Claude für Desktop finden Sie die Protokolle häufig unter:\n * Windows: `%USERPROFILE%\\AppData\\Local\\Claude\\Logs\\mcp\\\\.log` (der Pfad kann leicht abweichen)\n * macOS: `~/Library/Logs/Claude/mcp/\\.log` (Pfad kann leicht abweichen)\n\n## Unterstützung\n\nWenn Sie dieses Projekt hilfreich finden, denken Sie darüber nach, mir einen Kaffee zu spendieren, um die laufende Entwicklung und Wartung zu unterstützen.\n\n## Lizenz\n\nMIT-Lizenz – Einzelheiten finden Sie in der Datei „LICENSE“","German","tag","de-DE",{"_29":41,"_33":45,"_38":46},{"_31":42,"_33":43,"_35":44},"This server integrates AI assistants with ClickUp workspaces, enabling task, team, list, and board management through a secure OAuth2 authentication process.","ClickUp MCP Server","# ClickUp MCP Server\n\n[![smithery badge](https://smithery.ai/badge/@Nazruden/clickup-mcp-server)](https://smithery.ai/server/@Nazruden/clickup-mcp-server)\n[![npm version](https://badge.fury.io/js/%40nazruden%2Fclickup-server.svg)](https://badge.fury.io/js/%40nazruden%2Fclickup-server)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n $\"Buy$ \n\nA Model Context Protocol server implementation for ClickUp integration, enabling AI assistants to interact with ClickUp workspaces.\n\nThis server runs via **Stdio** as per the MCP specification when invoked by an MCP client.\n\n $\"ClickUp$ \n\n## Quick Start\n\nThis server uses your **ClickUp Personal API Token** for authentication.\n\n1. **Generate a Personal API Token:** In your ClickUp settings, navigate to \"My Settings\" > \"Apps\" and generate a token.\n2. **Configure your MCP Client (e.g., Claude for Desktop):** Set the required environment variable when configuring the server for your client.\n\nExample configuration snippet for an MCP client:\n\n```json\n{\n \"mcpServers\": {\n \"clickup\": {\n \"command\": \"npx\",\n \"args\": [\"@nazruden/clickup-server\"],\n \"env\": {\n \"CLICKUP_PERSONAL_TOKEN\": \"your_personal_api_token_here\"\n }\n }\n }\n}\n```\n\n3. **Restart your MCP Client.**\n\nThe server will be automatically downloaded and started by the MCP client when needed.\n\n### Installing via Smithery\n\nTo install ClickUp MCP Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@Nazruden/clickup-mcp-server):\n\n```bash\nnpx -y @smithery/cli install @Nazruden/clickup-mcp-server --client claude\n```\n\n## Environment Variables\n\n### Required\n\n- `CLICKUP_PERSONAL_TOKEN`: Your ClickUp Personal API Token. This is essential for the server to authenticate with the ClickUp API.\n\n### Optional\n\n- `LOG_LEVEL`: Logging level for the server. Supports `error`, `warn`, `info`, `debug`. Defaults to `info`.\n- `ENCRYPTION_KEY`: A persistent 32-byte hex-encoded key. The configuration system (`src/config/app.config.ts`) loads or generates this key, and `src/security.ts` contains encryption/decryption functions. However, this mechanism is **currently not used** for encrypting the `CLICKUP_PERSONAL_TOKEN` within the `ClickUpService`'s Personal API Token authentication flow.\n- `PORT`: Server port. This is **not used** by the default Stdio MCP server mode but might be relevant if an HTTP transport or additional HTTP features (like a separate health check endpoint) were explicitly added. Defaults to `3000` in the config if read.\n\n## Available Tools\n\nThe following MCP tools are currently implemented:\n\n### Task Management\n\n- `clickup_create_task`: Create a new task in a ClickUp list.\n - Requires: `list_id`, `name`.\n - Optional: `description`, `status`, `priority`, `assignees`, `due_date`, `time_estimate`, `tags`.\n- `clickup_update_task`: Update an existing task's properties.\n - Requires: `task_id`.\n - Optional: Any writable `ClickUpTask` properties.\n\n### Team & List Management\n\n- `clickup_get_teams`: Retrieve all accessible teams (Workspaces in ClickUp API v2).\n- `clickup_get_lists`: Get all lists in a specific folder.\n - Requires: `folder_id`.\n\n### Board Management\n\n- `clickup_create_board`: Create a new board in a ClickUp space.\n - Requires: `space_id`, `name`.\n\n### Space Management\n\n- `clickup_get_spaces`: Retrieves all Spaces for a given Workspace (Team).\n - Requires: `team_id` (Workspace ID).\n - Optional: `archived` (boolean, defaults to `false`).\n- `clickup_create_space`: Creates a new Space within a Workspace.\n - Requires: `team_id` (Workspace ID), `name`.\n - Optional: `multiple_assignees` (boolean), `features` (object with feature flags like `due_dates`, `time_tracking`, etc.).\n- `clickup_get_space`: Retrieves details for a specific Space.\n - Requires: `space_id`.\n- `clickup_update_space`: Updates an existing Space.\n - Requires: `space_id`.\n - Optional: `name`, `color`, `private`, `admin_can_manage`, `archived`, `features`.\n- `clickup_delete_space`: Deletes a Space.\n - Requires: `space_id`.\n\n### Folder Management\n\n- `clickup_get_folders`: Retrieves all Folders within a given Space.\n - Requires: `space_id`.\n - Optional: `archived` (boolean, defaults to `false`).\n- `clickup_create_folder`: Creates a new Folder within a Space.\n - Requires: `space_id`, `name`.\n- `clickup_get_folder`: Retrieves details for a specific Folder.\n - Requires: `folder_id`.\n- `clickup_update_folder`: Updates an existing Folder.\n - Requires: `folder_id`, `name`.\n- `clickup_delete_folder`: Deletes a Folder.\n - Requires: `folder_id`.\n\n### Custom Field Management\n\n- `clickup_get_custom_fields`: Retrieves all accessible Custom Fields for a given List.\n - Requires: `list_id`.\n- `clickup_set_task_custom_field_value`: Sets the value of a Custom Field on a specific task.\n - Requires: `task_id`, `field_id`, `value`.\n - Optional: `value_options` (object, e.g., `{ \"time\": true }` for date fields).\n- `clickup_remove_task_custom_field_value`: Removes/clears the value of a Custom Field from a specific task.\n - Requires: `task_id`, `field_id`.\n\n### Doc Management\n\n**Note:** ClickUp's API for Docs (especially v2, with some operations now using v3) has limitations. Content is primarily handled as Markdown. Advanced formatting or complex embeds might not be fully supported. Direct document deletion via API is not currently supported by ClickUp's V3 /docs endpoint; manage Doc lifecycle through archiving or page manipulation.\n\n- `clickup_search_docs`: Searches for Docs within a Workspace (Team).\n - Requires: `workspace_id`.\n - Optional: `query` (string), `include_archived` (boolean).\n- `clickup_create_doc`: Creates a new Doc.\n - Requires: `workspace_id`, `name`.\n - Optional: `parent` (object with `id` and `type`), `visibility` (string: \"private\", \"workspace\", \"public\"), `create_page` (boolean).\n- `clickup_get_doc_pages`: Retrieves the list of pages within a specific Doc.\n - Requires: `doc_id`.\n- `clickup_create_doc_page`: Creates a new page within a specific Doc.\n - Requires: `workspace_id`, `doc_id`, `name` (page title).\n - Optional: `content` (Markdown), `orderindex` (number, though v3 API may not use it), `parent_page_id` (string), `sub_title` (string), `content_format` (string).\n- `clickup_get_doc_page_content`: Retrieves the content (Markdown) of a specific Doc page.\n - Requires: `workspace_id`, `doc_id`, `page_id`.\n - Optional: `content_format` (string).\n- `clickup_edit_doc_page_content`: Updates the content and/or title of a specific Doc page.\n - Requires: `workspace_id`, `doc_id`, `page_id`, `content` (Markdown).\n - Optional: `title` (string, maps to API 'name'), `sub_title` (string), `content_edit_mode` (string: \"replace\", \"append\", \"prepend\"), `content_format` (string).\n\n### View Management\n\n- `clickup_get_views`: Retrieves all Views for a given parent resource (Team, Space, Folder, or List).\n - Requires: `parent_id` (ID of the parent resource), `parent_type` (string: \"team\", \"space\", \"folder\", or \"list\").\n- `clickup_create_view`: Creates a new View within a Team, Space, Folder, or List.\n - Requires: `parent_id`, `parent_type`, `name` (string: name of the new View), `type` (string: type of the View, e.g., \"list\", \"board\", \"calendar\", \"gantt\").\n - Optional: `grouping`, `divide`, `sorting`, `filters`, `columns`, `team_sidebar`, `settings` (objects defining view configurations).\n- `clickup_get_view_details`: Retrieves details for a specific View.\n - Requires: `view_id`.\n- `clickup_update_view`: Updates an existing View.\n - Requires: `view_id`.\n - Optional: `name` (string), `grouping`, `divide`, `sorting`, `filters`, `columns`, `team_sidebar`, `settings`.\n- `clickup_delete_view`: Deletes a View.\n - Requires: `view_id`.\n- `clickup_get_view_tasks`: Retrieves tasks belonging to a specific View.\n - Requires: `view_id`.\n - Optional: `page` (number: 0-indexed page number for pagination).\n\n## Development\n\n1. Clone the repository:\n ```bash\n git clone \n cd clickup-mcp-server\n ```\n2. Install dependencies:\n ```bash\n npm install\n ```\n3. Create a `.env` file in the root directory and add your `CLICKUP_PERSONAL_TOKEN`:\n ```env\n CLICKUP_PERSONAL_TOKEN=your_actual_personal_api_token_here\n LOG_LEVEL=debug\n ```\n4. Start in development mode (Stdio):\n The server will listen for MCP messages on stdin/stdout.\n\n ```bash\n npm run dev\n ```\n\n This uses `ts-node-dev` to run `src/index.ts`.\n\n5. Build for production:\n\n ```bash\n npm run build\n ```\n\n This compiles TypeScript to `dist/`.\n\n6. Run tests:\n ```bash\n npm test\n ```\n This runs Jest unit tests located in `src/__tests__`. Ensure you have a `.env.test` file (see `src/__tests__/setup.ts`).\n\n### Testing with MCP Inspector\n\nYou can test the server locally using the MCP Inspector:\n\n1. Ensure your `CLICKUP_PERSONAL_TOKEN` is available. You can either:\n - Set it in your shell environment before running the inspector.\n - Set it within the MCP Inspector UI if it provides an option for server environment variables.\n - Have it in your local `.env` file (as `src/index.ts` loads `dotenv`).\n2. Run the Inspector with the server:\n ```bash\n npx @modelcontextprotocol/inspector node --loader ts-node/esm src/index.ts\n ```\n The Inspector UI should launch, allowing you to connect to the server and call its tools.\n\n## Security\n\n- Authenticates using your ClickUp Personal API Token. **Keep this token secure and confidential.** Treat it like a password.\n- The server expects the `CLICKUP_PERSONAL_TOKEN` to be provided via an environment variable by the consuming MCP client or development environment.\n- The configuration system includes logic for an `ENCRYPTION_KEY` and `src/security.ts` has encryption functions, but this is **not currently applied** to the Personal API Token by the `ClickUpService`.\n- No sensitive data (like the token itself) is logged by default with `LOG_LEVEL=info`. Debug level might log more details.\n- Rate limiting for ClickUp API calls is handled by logging remaining requests (see `ClickUpService`).\n\n## Troubleshooting\n\n### Common Issues\n\n1. **Authentication Errors (401 from ClickUp API)**\n\n - Verify your `CLICKUP_PERSONAL_TOKEN` environment variable is correctly set and accessible by the server process.\n - Ensure the token is valid and not revoked in your ClickUp settings.\n - Check server logs for messages from `ClickUpService` regarding authentication.\n\n2. **Rate Limiting by ClickUp API**\n\n - The server logs rate limit information from ClickUp API responses.\n - If rate limits are hit frequently, this indicates high usage. The server itself does not implement queuing or complex backoff beyond what `axios` might do by default.\n\n3. **Server Not Starting / MCP Inspector Connection Issues**\n - Ensure `CLICKUP_PERSONAL_TOKEN` is set.\n - If using `npm run dev`, check for TypeScript or `ts-node-dev` errors in the console.\n - If using MCP Inspector with `node --loader ts-node/esm src/index.ts`, ensure `ts-node` and project dependencies are correctly installed.\n - Check for console errors from `src/index.ts` or `ClickUpService`.\n\n### Getting Server Logs\n\n- When run via `npm run dev` or `npm start`, logs go to the console.\n- If run by an MCP client (like Claude for Desktop), logs are typically managed by that client. For Claude for Desktop, logs can often be found at:\n - Windows: `%USERPROFILE%\\AppData\\Local\\Claude\\Logs\\mcp\\\\.log` (path may vary slightly)\n - macOS: `~/Library/Logs/Claude/mcp/\\.log` (path may vary slightly)\n\n## Support\n\nIf you find this project helpful, consider buying me a coffee to support ongoing development and maintenance.\n\n $\"Buy$ \n\n## License\n\nMIT License - see LICENSE file for details\n","English","en-US",{"_29":48,"_33":52,"_38":53},{"_31":49,"_33":50,"_35":51},"Este servidor integra asistentes de IA con espacios de trabajo de ClickUp, lo que permite la gestión de tareas, equipos, listas y tableros a través de un proceso de autenticación OAuth2 seguro.","Servidor MCP de ClickUp","# Servidor MCP de ClickUp\n\n[![insignia de herrería](https://smithery.ai/badge/@Nazruden/clickup-mcp-server)](https://smithery.ai/server/@Nazruden/clickup-mcp-server)\n\nUna implementación de servidor de protocolo de contexto de modelo para la integración de ClickUp, que permite que los asistentes de IA interactúen con los espacios de trabajo de ClickUp.\n\n## Inicio rápido\n\n1. Configurar Claude para escritorio:\n\n```json\n{\n \"mcpServers\": {\n \"clickup\": {\n \"command\": \"npx\",\n \"args\": [\"@mcp/clickup-server\"],\n \"env\": {\n \"CLICKUP_CLIENT_ID\": \"your_client_id\",\n \"CLICKUP_CLIENT_SECRET\": \"your_client_secret\",\n \"CLICKUP_REDIRECT_URI\": \"http://localhost:3000/oauth/callback\"\n }\n }\n }\n}\n```\n\n2. Reiniciar Claude para escritorio\n\n¡Listo! El servidor se descargará e iniciará automáticamente cuando sea necesario.\n\n### Instalación mediante herrería\n\nPara instalar ClickUp MCP Server para Claude Desktop automáticamente a través de [Smithery](https://smithery.ai/server/@Nazruden/clickup-mcp-server) :\n\n```bash\nnpx -y @smithery/cli install @Nazruden/clickup-mcp-server --client claude\n```\n\n## Variables de entorno\n\nVariables de entorno requeridas:\n\n* `CLICKUP_CLIENT_ID` : Su ID de cliente OAuth de ClickUp\n* `CLICKUP_CLIENT_SECRET` : Su secreto de cliente OAuth de ClickUp\n* `CLICKUP_REDIRECT_URI` : URI de redirección de OAuth (predeterminado: )\n\nVariables de entorno opcionales:\n\n* `PORT` : Puerto del servidor (predeterminado: 3000)\n* `LOG_LEVEL` : Nivel de registro (predeterminado: información)\n\n## Herramientas disponibles\n\n### Gestión de tareas\n\n* `clickup_create_task` : Crea una nueva tarea en una lista de ClickUp\n* `clickup_update_task` : Actualizar las propiedades de una tarea existente\n\n### Gestión de equipos y listas\n\n* `clickup_get_teams` : Recuperar todos los equipos accesibles\n* `clickup_get_lists` : Obtener todas las listas en una carpeta específica\n\n### Junta Directiva\n\n* `clickup_create_board` : Crea un nuevo tablero en un espacio ClickUp\n\n## Desarrollo\n\n1. Clonar el repositorio\n2. Instalar dependencias:\n\n```bash\nnpm install\n```\n\n3. Iniciar en modo de desarrollo:\n\n```bash\nnpm run dev\n```\n\n4. Construir para producción:\n\n```bash\nnpm run build\n```\n\n5. Ejecutar pruebas:\n\n```bash\nnpm test\n```\n\n## Seguridad\n\n* Todos los tokens están encriptados en reposo\n* Flujo OAuth2 para autenticación segura\n* No se registran datos confidenciales\n* Limitación de velocidad para evitar el abuso de la API\n\n## Solución de problemas\n\n### Problemas comunes\n\n1. **Errores de autenticación**\n\n * Verifique sus credenciales de OAuth en las variables de entorno\n * Comprobar la caducidad del token\n * Asegúrese de que la URL de redirección sea correcta\n\n2. **Limitación de velocidad**\n\n * El servidor implementa el manejo automático del límite de velocidad\n * Consulte los registros para ver las advertencias sobre el límite de velocidad\n * Considere implementar la agrupación de solicitudes\n\n3. **El servidor no se inicia**\n\n * Compruebe que las variables de entorno estén configuradas correctamente\n * Verificar que el puerto 3000 esté disponible\n * Consulta los registros de Claude para el escritorio\n\n### Obteniendo registros\n\nLos registros de Claude for Desktop se pueden encontrar en:\n\n* Windows: `%USERPROFILE%\\AppData\\Local\\Claude\\Logs\\mcp*.log`\n* macOS: `~/Library/Logs/Claude/mcp*.log`\n\n## Licencia\n\nLicencia MIT: consulte el archivo de LICENCIA para obtener más detalles","Spanish","es-ES",{"_29":55,"_33":59,"_38":60},{"_31":56,"_33":57,"_35":58},"このサーバーは、AI アシスタントを ClickUp ワークスペースと統合し、安全な OAuth2 認証プロセスを通じてタスク、チーム、リスト、ボードの管理を可能にします。","ClickUp MCP サーバー","# ClickUp MCP サーバー\n\n[![鍛冶屋のバッジ](https://smithery.ai/badge/@Nazruden/clickup-mcp-server)](https://smithery.ai/server/@Nazruden/clickup-mcp-server)\n\nClickUp 統合用のモデルコンテキストプロトコルサーバー実装。AI アシスタントが ClickUp ワークスペースと対話できるようになります。\n\n## クイックスタート\n\n1. Claude をデスクトップ用に設定する:\n\n```json\n{\n \"mcpServers\": {\n \"clickup\": {\n \"command\": \"npx\",\n \"args\": [\"@mcp/clickup-server\"],\n \"env\": {\n \"CLICKUP_CLIENT_ID\": \"your_client_id\",\n \"CLICKUP_CLIENT_SECRET\": \"your_client_secret\",\n \"CLICKUP_REDIRECT_URI\": \"http://localhost:3000/oauth/callback\"\n }\n }\n }\n}\n```\n\n2. デスクトップ版のClaudeを再起動\n\nこれで完了です。サーバーは必要に応じて自動的にダウンロードされ、起動されます。\n\n### Smithery経由でインストール\n\n[Smithery](https://smithery.ai/server/@Nazruden/clickup-mcp-server)経由で Claude Desktop 用の ClickUp MCP Server を自動的にインストールするには:\n\n```bash\nnpx -y @smithery/cli install @Nazruden/clickup-mcp-server --client claude\n```\n\n## 環境変数\n\n必要な環境変数:\n\n* `CLICKUP_CLIENT_ID` : ClickUp OAuthクライアントID\n* `CLICKUP_CLIENT_SECRET` : ClickUp OAuthクライアントシークレット\n* `CLICKUP_REDIRECT_URI` : OAuth リダイレクト URI (デフォルト: )\n\nオプションの環境変数:\n\n* `PORT` : サーバーポート（デフォルト: 3000）\n* `LOG_LEVEL` : ログレベル（デフォルト: info）\n\n## 利用可能なツール\n\n### タスク管理\n\n* `clickup_create_task` : ClickUp リストに新しいタスクを作成する\n* `clickup_update_task` : 既存のタスクのプロパティを更新する\n\n### チームとリストの管理\n\n* `clickup_get_teams` : アクセス可能なすべてのチームを取得する\n* `clickup_get_lists` : 特定のフォルダ内のすべてのリストを取得する\n\n### 取締役会運営\n\n* `clickup_create_board` : ClickUpスペースに新しいボードを作成する\n\n## 発達\n\n1. リポジトリをクローンする\n2. 依存関係をインストールします:\n\n```bash\nnpm install\n```\n\n3. 開発モードで開始します:\n\n```bash\nnpm run dev\n```\n\n4. 生産用にビルド:\n\n```bash\nnpm run build\n```\n\n5. テストを実行します:\n\n```bash\nnpm test\n```\n\n## 安全\n\n* すべてのトークンは保存時に暗号化されます\n* 安全な認証のためのOAuth2フロー\n* 機密データは記録されません\n* APIの不正使用を防ぐためのレート制限\n\n## トラブルシューティング\n\n### よくある問題\n\n1. **認証エラー**\n\n * 環境変数でOAuth認証情報を確認する\n * トークンの有効期限を確認する\n * 適切なリダイレクトURIを確認する\n\n2. **レート制限**\n\n * サーバーは自動レート制限処理を実装しています\n * レート制限の警告がないかログを確認する\n * リクエストのバッチ処理の実装を検討する\n\n3. **サーバーが起動しない**\n\n * 環境変数が正しく設定されているか確認する\n * ポート3000が利用可能であることを確認する\n * クロードのデスクトップログを確認する\n\n### ログの取得\n\nClaude for Desktop のログは次の場所にあります:\n\n* Windows: `%USERPROFILE%\\AppData\\Local\\Claude\\Logs\\mcp*.log`\n* macOS: `~/Library/Logs/Claude/mcp*.log`\n\n## ライセンス\n\nMITライセンス - 詳細はLICENSEファイルを参照","Japanese","ja-JP",{"_29":62,"_33":66,"_38":67},{"_31":63,"_33":64,"_35":65},"이 서버는 AI 어시스턴트를 ClickUp 작업 공간과 통합하여 안전한 OAuth2 인증 프로세스를 통해 작업, 팀, 목록 및 보드 관리를 가능하게 합니다.","ClickUp MCP 서버","# ClickUp MCP 서버\n\n[![대장간 배지](https://smithery.ai/badge/@Nazruden/clickup-mcp-server)](https://smithery.ai/server/@Nazruden/clickup-mcp-server)\n\nClickUp 통합을 위한 모델 컨텍스트 프로토콜 서버 구현으로, AI 어시스턴트가 ClickUp 작업 공간과 상호 작용할 수 있습니다.\n\n## 빠른 시작\n\n1. 데스크톱에 Claude 구성:\n\n지엑스피1\n\n2. 데스크톱용 Claude 재시작\n\n이제 완료되었습니다! 서버가 자동으로 다운로드되어 필요할 때 시작됩니다.\n\n### Smithery를 통해 설치\n\n[Smithery를](https://smithery.ai/server/@Nazruden/clickup-mcp-server) 통해 Claude Desktop에 ClickUp MCP Server를 자동으로 설치하려면:\n\n```bash\nnpx -y @smithery/cli install @Nazruden/clickup-mcp-server --client claude\n```\n\n## 환경 변수\n\n필수 환경 변수:\n\n* `CLICKUP_CLIENT_ID` : ClickUp OAuth 클라이언트 ID\n* `CLICKUP_CLIENT_SECRET` : ClickUp OAuth 클라이언트 비밀번호\n* `CLICKUP_REDIRECT_URI` : OAuth 리디렉션 URI(기본값: )\n\n선택적 환경 변수:\n\n* `PORT` : 서버 포트(기본값: 3000)\n* `LOG_LEVEL` : 로깅 레벨(기본값: info)\n\n## 사용 가능한 도구\n\n### 작업 관리\n\n* `clickup_create_task` : ClickUp 목록에 새 작업을 만듭니다.\n* `clickup_update_task` : 기존 작업의 속성을 업데이트합니다.\n\n### 팀 및 목록 관리\n\n* `clickup_get_teams` : 접근 가능한 모든 팀을 검색합니다.\n* `clickup_get_lists` : 특정 폴더의 모든 목록을 가져옵니다.\n\n### 이사회 관리\n\n* `clickup_create_board` : ClickUp 공간에 새 보드를 만듭니다.\n\n## 개발\n\n1. 저장소를 복제합니다\n2. 종속성 설치:\n\n```bash\nnpm install\n```\n\n3. 개발 모드에서 시작:\n\n```bash\nnpm run dev\n```\n\n4. 프로덕션을 위해 빌드:\n\n```bash\nnpm run build\n```\n\n5. 테스트 실행:\n\n```bash\nnpm test\n```\n\n## 보안\n\n* 모든 토큰은 저장 시 암호화됩니다.\n* 보안 인증을 위한 OAuth2 흐름\n* 민감한 데이터가 기록되지 않았습니다\n* API 남용을 방지하기 위한 속도 제한\n\n## 문제 해결\n\n### 일반적인 문제\n\n1. **인증 오류**\n\n * 환경 변수에서 OAuth 자격 증명을 확인하세요.\n * 토큰 만료 확인\n * 적절한 리디렉션 URI를 확인하세요\n\n2. **속도 제한**\n\n * 서버는 자동 속도 제한 처리를 구현합니다.\n * 속도 제한 경고에 대한 로그를 확인하세요.\n * 요청 일괄 처리 구현을 고려하세요\n\n3. **서버가 시작되지 않음**\n\n * 환경 변수가 제대로 설정되었는지 확인하세요\n * 포트 3000을 사용할 수 있는지 확인하세요\n * Claude의 데스크톱 로그를 확인하세요\n\n### 로그 가져오기\n\nClaude for Desktop 로그는 다음에서 찾을 수 있습니다.\n\n* Windows: `%USERPROFILE%\\AppData\\Local\\Claude\\Logs\\mcp*.log`\n* macOS: `~/Library/Logs/Claude/mcp*.log`\n\n## 특허\n\nMIT 라이센스 - 자세한 내용은 라이센스 파일을 참조하세요.","Korean","ko-KR",{"_29":69,"_33":73,"_38":74},{"_31":70,"_33":71,"_35":72},"Этот сервер интегрирует помощников ИИ с рабочими пространствами ClickUp, обеспечивая управление задачами, командами, списками и досками с помощью безопасного процесса аутентификации OAuth2.","ClickUp MCP-сервер","# ClickUp MCP-сервер\n\n[![значок кузнеца](https://smithery.ai/badge/@Nazruden/clickup-mcp-server)](https://smithery.ai/server/@Nazruden/clickup-mcp-server) [![npm-версия](https://badge.fury.io/js/%40nazruden%2Fclickup-server.svg)](https://badge.fury.io/js/%40nazruden%2Fclickup-server) [![Лицензия: Массачусетский технологический институт](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nРеализация сервера Model Context Protocol для интеграции ClickUp, позволяющая помощникам на базе искусственного интеллекта взаимодействовать с рабочими пространствами ClickUp.\n\nЭтот сервер работает через **Stdio** согласно спецификации MCP при вызове клиентом MCP.\n\n## Быстрый старт\n\nЭтот сервер использует ваш **ClickUp Personal API Token** для аутентификации.\n\n1. **Создайте персональный токен API:** в настройках ClickUp перейдите в «Мои настройки» > «Приложения» и создайте токен.\n2. **Настройте свой клиент MCP (например, Claude for Desktop):** установите требуемую переменную среды при настройке сервера для вашего клиента.\n\nПример фрагмента конфигурации для клиента MCP:\n\n```json\n{\n \"mcpServers\": {\n \"clickup\": {\n \"command\": \"npx\",\n \"args\": [\"@nazruden/clickup-server\"],\n \"env\": {\n \"CLICKUP_PERSONAL_TOKEN\": \"your_personal_api_token_here\"\n }\n }\n }\n}\n```\n\n3. **Перезапустите MCP-клиент.**\n\nПри необходимости сервер будет автоматически загружен и запущен клиентом MCP.\n\n### Установка через Smithery\n\nЧтобы автоматически установить ClickUp MCP Server для Claude Desktop через [Smithery](https://smithery.ai/server/@Nazruden/clickup-mcp-server) :\n\n```bash\nnpx -y @smithery/cli install @Nazruden/clickup-mcp-server --client claude\n```\n\n## Переменные среды\n\n### Необходимый\n\n* `CLICKUP_PERSONAL_TOKEN` : Ваш ClickUp Personal API Token. Это необходимо для аутентификации сервера с ClickUp API.\n\n### Необязательный\n\n* `LOG_LEVEL` : Уровень ведения журнала для сервера. Поддерживает `error` , `warn` , `info` , `debug` . По умолчанию `info` .\n* `ENCRYPTION_KEY` : Постоянный 32-байтовый шестнадцатеричный ключ. Система конфигурации ( `src/config/app.config.ts` ) загружает или генерирует этот ключ, а `src/security.ts` содержит функции шифрования/дешифрования. Однако **в настоящее время этот механизм не используется** для шифрования `CLICKUP_PERSONAL_TOKEN` в потоке аутентификации Personal API Token `ClickUpService` .\n* `PORT` : Порт сервера. **Не используется** в режиме сервера Stdio MCP по умолчанию, но может быть важен, если явно добавлены транспорт HTTP или дополнительные функции HTTP (например, отдельная конечная точка проверки работоспособности). По умолчанию в конфигурации `3000` если считано.\n\n## Доступные инструменты\n\nВ настоящее время реализованы следующие инструменты MCP:\n\n### Управление задачами\n\n* `clickup_create_task` : создать новую задачу в списке ClickUp.\n * Требуется: `list_id` , `name` .\n * Необязательно: `description` , `status` , `priority` , `assignees` , `due_date` , `time_estimate` , `tags` .\n* `clickup_update_task` : обновить свойства существующей задачи.\n * Требуется: `task_id` .\n * Необязательно: любые записываемые свойства `ClickUpTask` .\n\n### Управление командой и списком\n\n* `clickup_get_teams` : получение всех доступных команд (рабочие пространства в ClickUp API v2).\n* `clickup_get_lists` : Получить все списки в определенной папке.\n * Требуется: `folder_id` .\n\n### Совет директоров\n\n* `clickup_create_board` : создать новую доску в пространстве ClickUp.\n * Требуется: `space_id` , `name` .\n\n### Управление пространством\n\n* `clickup_get_spaces` : извлекает все пространства для заданного рабочего пространства (команды).\n * Требуется: `team_id` (идентификатор рабочей области).\n * Необязательно: `archived` (логическое значение, по умолчанию `false` ).\n* `clickup_create_space` : создает новое пространство внутри рабочего пространства.\n * Требуется: `team_id` (ID рабочей области), `name` .\n * Необязательно: `multiple_assignees` (логическое значение), `features` (объект с флагами функций, такими как `due_dates` , `time_tracking` и т. д.).\n* `clickup_get_space` : Извлекает сведения о конкретном пространстве.\n * Требуется: `space_id` .\n* `clickup_update_space` : Обновляет существующее пространство.\n * Требуется: `space_id` .\n * Необязательно: `name` , `color` , `private` , `admin_can_manage` , `archived` , `features` .\n* `clickup_delete_space` : Удаляет пробел.\n * Требуется: `space_id` .\n\n### Управление папками\n\n* `clickup_get_folders` : извлекает все папки в указанном пространстве.\n * Требуется: `space_id` .\n * Необязательно: `archived` (логическое значение, по умолчанию `false` ).\n* `clickup_create_folder` : создает новую папку в пространстве.\n * Требуется: `space_id` , `name` .\n* `clickup_get_folder` : Извлекает сведения о конкретной папке.\n * Требуется: `folder_id` .\n* `clickup_update_folder` : Обновляет существующую папку.\n * Требуется: `folder_id` , `name` .\n* `clickup_delete_folder` : Удаляет папку.\n * Требуется: `folder_id` .\n\n### Управление пользовательскими полями\n\n* `clickup_get_custom_fields` : извлекает все доступные пользовательские поля для указанного списка.\n * Требуется: `list_id` .\n* `clickup_set_task_custom_field_value` : Устанавливает значение настраиваемого поля для определенной задачи.\n * Требуется: `task_id` , `field_id` , `value` .\n * Необязательно: `value_options` (объект, например, `{ \"time\": true }` для полей даты).\n* `clickup_remove_task_custom_field_value` : удаляет/очищает значение настраиваемого поля из определенной задачи.\n * Требуется: `task_id` , `field_id` .\n\n### Управление документами\n\n**Примечание:** API ClickUp для Docs (особенно v2, с некоторыми операциями, которые теперь используют v3) имеет ограничения. Контент в основном обрабатывается как Markdown. Расширенное форматирование или сложные вставки могут не поддерживаться полностью. Прямое удаление документов через API в настоящее время не поддерживается конечной точкой ClickUp V3 /docs; управляйте жизненным циклом Doc посредством архивации или манипулирования страницами.\n\n* `clickup_search_docs` : Поиск документов в рабочей области (команда).\n * Требуется: `workspace_id` .\n * Необязательно: `query` (строка), `include_archived` (логическое значение).\n* `clickup_create_doc` : Создает новый документ.\n * Требуется: `workspace_id` , `name` .\n * Необязательно: `parent` (объект с `id` и `type` ), `visibility` (строка: «private», «workspace», «public»), `create_page` (логическое значение).\n* `clickup_get_doc_pages` : Извлекает список страниц в определенном документе.\n * Требуется: `doc_id` .\n* `clickup_create_doc_page` : создает новую страницу в определенном документе.\n * Требуется: `workspace_id` , `doc_id` , `name` (заголовок страницы).\n * Необязательно: `content` (Markdown), `orderindex` (число, хотя API v3 может его не использовать), `parent_page_id` (строка), `sub_title` (строка), `content_format` (строка).\n* `clickup_get_doc_page_content` : извлекает содержимое (Markdown) определенной страницы документа.\n * Требуется: `workspace_id` , `doc_id` , `page_id` .\n * Необязательно: `content_format` (строка).\n* `clickup_edit_doc_page_content` : обновляет содержимое и/или заголовок определенной страницы документа.\n * Требуется: `workspace_id` , `doc_id` , `page_id` , `content` (Markdown).\n * Необязательно: `title` (строка, сопоставляется с API «name»), `sub_title` (строка), `content_edit_mode` (строка: «replace», «append», «prepend»), `content_format` (строка).\n\n### Посмотреть управление\n\n* `clickup_get_views` : извлекает все представления для заданного родительского ресурса (команда, пространство, папка или список).\n * Требуется: `parent_id` (идентификатор родительского ресурса), `parent_type` (строка: «team», «space», «folder» или «list»).\n* `clickup_create_view` : создает новое представление в команде, пространстве, папке или списке.\n * Требуется: `parent_id` , `parent_type` , `name` (строка: имя нового представления), `type` (строка: тип представления, например, «список», «доска», «календарь», «Гантт»).\n * Необязательно: `grouping` , `divide` , `sorting` , `filters` , `columns` , `team_sidebar` , `settings` (объекты, определяющие конфигурации представления).\n* `clickup_get_view_details` : Извлекает сведения о конкретном представлении.\n * Требуется: `view_id` .\n* `clickup_update_view` : Обновляет существующее представление.\n * Требуется: `view_id` .\n * Необязательно: `name` (строка), `grouping` , `divide` , `sorting` , `filters` , `columns` , `team_sidebar` , `settings` .\n* `clickup_delete_view` : Удаляет представление.\n * Требуется: `view_id` .\n* `clickup_get_view_tasks` : Извлекает задачи, относящиеся к определенному представлению.\n * Требуется: `view_id` .\n * Необязательно: `page` (номер: 0-индексированный номер страницы для нумерации страниц).\n\n## Разработка\n\n1. Клонируйте репозиторий:\n\n ```bash\n git clone \n cd clickup-mcp-server\n ```\n\n2. Установить зависимости:\n\n ```bash\n npm install\n ```\n\n3. Создайте файл `.env` в корневом каталоге и добавьте свой `CLICKUP_PERSONAL_TOKEN` :\n\n ```env\n CLICKUP_PERSONAL_TOKEN=your_actual_personal_api_token_here\n LOG_LEVEL=debug\n ```\n\n4. Запуск в режиме разработки (Stdio): сервер будет прослушивать сообщения MCP на stdin/stdout.\n\n ```bash\n npm run dev\n ```\n\n Здесь для запуска `src/index.ts` используется `ts-node-dev` .\n\n5. Сборка для производства:\n\n ```bash\n npm run build\n ```\n\n Это скомпилирует TypeScript в `dist/` .\n\n6. Проведите тесты:\n\n ```bash\n npm test\n ```\n\n Это запускает модульные тесты Jest, расположенные в `src/__tests__` . Убедитесь, что у вас есть файл `.env.test` (см. `src/__tests__/setup.ts` ).\n\n### Тестирование с помощью MCP Inspector\n\nВы можете протестировать сервер локально с помощью MCP Inspector:\n\n1. Убедитесь, что ваш `CLICKUP_PERSONAL_TOKEN` доступен. Вы можете:\n\n * Установите его в своей оболочке перед запуском инспектора.\n * Установите его в пользовательском интерфейсе MCP Inspector, если он предоставляет возможность для переменных среды сервера.\n * Поместите его в локальный файл `.env` (так как `src/index.ts` загружает `dotenv` ).\n\n2. Запустите инспектор с сервером:\n\n ```bash\n npx @modelcontextprotocol/inspector node --loader ts-node/esm src/index.ts\n ```\n\n Должен запуститься пользовательский интерфейс Inspector, позволяющий подключиться к серверу и вызвать его инструменты.\n\n## Безопасность\n\n* Аутентификация с использованием вашего ClickUp Personal API Token. **Сохраняйте этот токен в безопасности и конфиденциальности.** Относитесь к нему как к паролю.\n* Сервер ожидает, что `CLICKUP_PERSONAL_TOKEN` будет предоставлен через переменную среды потребляющим клиентом MCP или средой разработки.\n* Система конфигурации включает логику для `ENCRYPTION_KEY` , а `src/security.ts` имеет функции шифрования, но **в настоящее время это не применяется** к токену Personal API службой `ClickUpService` .\n* Никакие конфиденциальные данные (например, сам токен) не регистрируются по умолчанию с `LOG_LEVEL=info` . Уровень отладки может регистрировать больше подробностей.\n* Ограничение частоты вызовов API ClickUp осуществляется путем регистрации оставшихся запросов (см. `ClickUpService` ).\n\n## Поиск неисправностей\n\n### Общие проблемы\n\n1. **Ошибки аутентификации (401 из ClickUp API)**\n\n * Убедитесь, что переменная среды `CLICKUP_PERSONAL_TOKEN` установлена правильно и доступна серверному процессу.\n * Убедитесь, что токен действителен и не отозван в настройках ClickUp.\n * Проверьте журналы сервера на наличие сообщений от `ClickUpService` , касающихся аутентификации.\n\n2. **Ограничение скорости с помощью ClickUp API**\n\n * Сервер регистрирует информацию об ограничении скорости из ответов API ClickUp.\n * Если ограничения скорости достигаются часто, это указывает на высокую загрузку. Сам сервер не реализует очередность или сложную отсрочку, помимо того, что `axios` может делать по умолчанию.\n\n3. **Сервер не запускается / Проблемы с подключением MCP Inspector**\n\n * Убедитесь, что `CLICKUP_PERSONAL_TOKEN` установлен.\n * При использовании `npm run dev` проверьте наличие ошибок TypeScript или `ts-node-dev` в консоли.\n * При использовании MCP Inspector с `node --loader ts-node/esm src/index.ts` убедитесь, что зависимости `ts-node` и проекта установлены правильно.\n * Проверьте наличие ошибок консоли из `src/index.ts` или `ClickUpService` .\n\n### Получение журналов сервера\n\n* При запуске через `npm run dev` или `npm start` логи отправляются в консоль.\n* Если запущен клиент MCP (например, Claude for Desktop), журналы обычно управляются этим клиентом. Для Claude for Desktop журналы часто можно найти по адресу:\n * Windows: `%USERPROFILE%\\AppData\\Local\\Claude\\Logs\\mcp\\\\.log` (путь может немного отличаться)\n * macOS: `~/Library/Logs/Claude/mcp/\\.log` (путь может немного отличаться)\n\n## Поддерживать\n\nЕсли вы считаете этот проект полезным, рассмотрите возможность угостить меня кофе, чтобы поддержать текущую разработку и поддержку.\n\n## Лицензия\n\nЛицензия MIT — подробности см. в файле LICENSE","Russian","ru-RU",{"_29":76,"_33":80,"_38":81},{"_31":77,"_33":78,"_35":79},"该服务器将 AI 助手与 ClickUp 工作区集成，通过安全的 OAuth2 身份验证流程实现任务、团队、列表和董事会管理。","ClickUp MCP 服务器","# ClickUp MCP 服务器\n\n[![铁匠徽章](https://smithery.ai/badge/@Nazruden/clickup-mcp-server)](https://smithery.ai/server/@Nazruden/clickup-mcp-server)\n\n用于 ClickUp 集成的模型上下文协议服务器实现，使 AI 助手能够与 ClickUp 工作区进行交互。\n\n## 快速入门\n\n1. 配置 Claude 桌面版：\n\n```json\n{\n \"mcpServers\": {\n \"clickup\": {\n \"command\": \"npx\",\n \"args\": [\"@mcp/clickup-server\"],\n \"env\": {\n \"CLICKUP_CLIENT_ID\": \"your_client_id\",\n \"CLICKUP_CLIENT_SECRET\": \"your_client_secret\",\n \"CLICKUP_REDIRECT_URI\": \"http://localhost:3000/oauth/callback\"\n }\n }\n }\n}\n```\n\n2. 重启 Claude 桌面版\n\n就是这样！服务器将在需要时自动下载并启动。\n\n### 通过 Smithery 安装\n\n要通过[Smithery](https://smithery.ai/server/@Nazruden/clickup-mcp-server)自动为 Claude Desktop 安装 ClickUp MCP 服务器：\n\n```bash\nnpx -y @smithery/cli install @Nazruden/clickup-mcp-server --client claude\n```\n\n## 环境变量\n\n所需的环境变量：\n\n* `CLICKUP_CLIENT_ID` ：您的 ClickUp OAuth 客户端 ID\n* `CLICKUP_CLIENT_SECRET` ：您的 ClickUp OAuth 客户端密钥\n* `CLICKUP_REDIRECT_URI` ：OAuth 重定向 URI（默认值：）\n\n可选的环境变量：\n\n* `PORT` ：服务器端口（默认值：3000）\n* `LOG_LEVEL` ：日志记录级别（默认值：info）\n\n## 可用工具\n\n### 任务管理\n\n* `clickup_create_task` ：在 ClickUp 列表中创建新任务\n* `clickup_update_task` ：更新现有任务的属性\n\n### 团队和列表管理\n\n* `clickup_get_teams` ：检索所有可访问的团队\n* `clickup_get_lists` ：获取特定文件夹中的所有列表\n\n### 董事会管理\n\n* `clickup_create_board` ：在 ClickUp 空间中创建一个新板\n\n## 发展\n\n1. 克隆存储库\n2. 安装依赖项：\n\n```bash\nnpm install\n```\n\n3. 以开发模式启动：\n\n```bash\nnpm run dev\n```\n\n4. 为生产而构建：\n\n```bash\nnpm run build\n```\n\n5. 运行测试：\n\n```bash\nnpm test\n```\n\n## 安全\n\n* 所有令牌均处于静态加密状态\n* 用于安全身份验证的 OAuth2 流程\n* 未记录敏感数据\n* 限制速率以防止 API 滥用\n\n## 故障排除\n\n### 常见问题\n\n1. **身份验证错误**\n\n * 在环境变量中验证您的 OAuth 凭据\n * 检查令牌过期\n * 确保正确的重定向 URI\n\n2. **速率限制**\n\n * 服务器实现自动速率限制处理\n * 检查日志中的速率限制警告\n * 考虑实施请求批处理\n\n3. **服务器未启动**\n\n * 检查环境变量是否正确设置\n * 验证端口 3000 是否可用\n * 检查 Claude 的桌面日志\n\n### 获取日志\n\n您可以在以下位置找到 Claude for Desktop 日志：\n\n* Windows： `%USERPROFILE%\\AppData\\Local\\Claude\\Logs\\mcp*.log`\n* macOS： `~/Library/Logs/Claude/mcp*.log`\n\n## 执照\n\nMIT 许可证 - 详情请参阅许可证文件","Chinese","zh-CN","githubUser","locale",{"_85":86,"_87":88,"_13":115,"_124":42,"_125":42,"_126":127,"_131":132,"_155":-5,"_16":156,"_157":158,"_159":160,"_33":43,"_171":145,"_172":173,"_177":178,"_179":180,"_185":-5,"_167":141,"_186":187,"_190":191,"_146":192,"_193":194},"addedAt","2025-02-07T00:00:13.329329248Z","argumentsJsonSchema",{"_89":90,"_112":113,"_96":114},"properties",{"_91":92,"_98":99,"_102":103,"_105":106,"_109":110},"PORT",{"_93":94,"_31":95,"_96":97},"default","3000","Server port","type","string","LOG_LEVEL",{"_93":100,"_31":101,"_96":97},"info","Logging level","CLICKUP_CLIENT_ID",{"_31":104,"_96":97},"Your ClickUp OAuth client ID","CLICKUP_REDIRECT_URI",{"_93":107,"_31":108,"_96":97},"http://localhost:3000/oauth/callback","OAuth redirect URI","CLICKUP_CLIENT_SECRET",{"_31":111,"_96":97},"Your ClickUp OAuth client secret","required",[102,109],"object",[116,117,118,119,120,121,122,123],"category:project-management","category:app-automation","environment:network","hosting:remote-capable","language:typescript","security_grade:a","quality_grade:a","license_grade:a","descriptionMarkdown","descriptionPlainText","githubProject",{"_35":128,"_129":130},"# ClickUp MCP Server\n\n[![smithery badge](https://smithery.ai/badge/@Nazruden/clickup-mcp-server)](https://smithery.ai/server/@Nazruden/clickup-mcp-server)\n[![npm version](https://badge.fury.io/js/%40nazruden%2Fclickup-server.svg)](https://badge.fury.io/js/%40nazruden%2Fclickup-server)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n $\"Buy$ \n\nA Model Context Protocol server implementation for ClickUp integration, enabling AI assistants to interact with ClickUp workspaces.\n\nThis server runs via **Stdio** as per the MCP specification when invoked by an MCP client.\n\n $\"ClickUp$ \n\n## Quick Start\n\nThis server uses your **ClickUp Personal API Token** for authentication.\n\n1. **Generate a Personal API Token:** In your ClickUp settings, navigate to \"My Settings\" > \"Apps\" and generate a token.\n2. **Configure your MCP Client (e.g., Claude for Desktop):** Set the required environment variable when configuring the server for your client.\n\nExample configuration snippet for an MCP client:\n\n```json\n{\n \"mcpServers\": {\n \"clickup\": {\n \"command\": \"npx\",\n \"args\": [\"@nazruden/clickup-server\"],\n \"env\": {\n \"CLICKUP_PERSONAL_TOKEN\": \"your_personal_api_token_here\"\n }\n }\n }\n}\n```\n\n3. **Restart your MCP Client.**\n\nThe server will be automatically downloaded and started by the MCP client when needed.\n\n### Installing via Smithery\n\nTo install ClickUp MCP Server for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@Nazruden/clickup-mcp-server):\n\n```bash\nnpx -y @smithery/cli install @Nazruden/clickup-mcp-server --client claude\n```\n\n## Environment Variables\n\n### Required\n\n- `CLICKUP_PERSONAL_TOKEN`: Your ClickUp Personal API Token. This is essential for the server to authenticate with the ClickUp API.\n\n### Optional\n\n- `LOG_LEVEL`: Logging level for the server. Supports `error`, `warn`, `info`, `debug`. Defaults to `info`.\n- `ENCRYPTION_KEY`: A persistent 32-byte hex-encoded key. The configuration system (`src/config/app.config.ts`) loads or generates this key, and `src/security.ts` contains encryption/decryption functions. However, this mechanism is **currently not used** for encrypting the `CLICKUP_PERSONAL_TOKEN` within the `ClickUpService`'s Personal API Token authentication flow.\n- `PORT`: Server port. This is **not used** by the default Stdio MCP server mode but might be relevant if an HTTP transport or additional HTTP features (like a separate health check endpoint) were explicitly added. Defaults to `3000` in the config if read.\n\n## Available Tools\n\nThe following MCP tools are currently implemented:\n\n### Task Management\n\n- `clickup_create_task`: Create a new task in a ClickUp list.\n - Requires: `list_id`, `name`.\n - Optional: `description`, `status`, `priority`, `assignees`, `due_date`, `time_estimate`, `tags`.\n- `clickup_update_task`: Update an existing task's properties.\n - Requires: `task_id`.\n - Optional: Any writable `ClickUpTask` properties.\n\n### Team & List Management\n\n- `clickup_get_teams`: Retrieve all accessible teams (Workspaces in ClickUp API v2).\n- `clickup_get_lists`: Get all lists in a specific folder.\n - Requires: `folder_id`.\n\n### Board Management\n\n- `clickup_create_board`: Create a new board in a ClickUp space.\n - Requires: `space_id`, `name`.\n\n### Space Management\n\n- `clickup_get_spaces`: Retrieves all Spaces for a given Workspace (Team).\n - Requires: `team_id` (Workspace ID).\n - Optional: `archived` (boolean, defaults to `false`).\n- `clickup_create_space`: Creates a new Space within a Workspace.\n - Requires: `team_id` (Workspace ID), `name`.\n - Optional: `multiple_assignees` (boolean), `features` (object with feature flags like `due_dates`, `time_tracking`, etc.).\n- `clickup_get_space`: Retrieves details for a specific Space.\n - Requires: `space_id`.\n- `clickup_update_space`: Updates an existing Space.\n - Requires: `space_id`.\n - Optional: `name`, `color`, `private`, `admin_can_manage`, `archived`, `features`.\n- `clickup_delete_space`: Deletes a Space.\n - Requires: `space_id`.\n\n### Folder Management\n\n- `clickup_get_folders`: Retrieves all Folders within a given Space.\n - Requires: `space_id`.\n - Optional: `archived` (boolean, defaults to `false`).\n- `clickup_create_folder`: Creates a new Folder within a Space.\n - Requires: `space_id`, `name`.\n- `clickup_get_folder`: Retrieves details for a specific Folder.\n - Requires: `folder_id`.\n- `clickup_update_folder`: Updates an existing Folder.\n - Requires: `folder_id`, `name`.\n- `clickup_delete_folder`: Deletes a Folder.\n - Requires: `folder_id`.\n\n### Custom Field Management\n\n- `clickup_get_custom_fields`: Retrieves all accessible Custom Fields for a given List.\n - Requires: `list_id`.\n- `clickup_set_task_custom_field_value`: Sets the value of a Custom Field on a specific task.\n - Requires: `task_id`, `field_id`, `value`.\n - Optional: `value_options` (object, e.g., `{ \"time\": true }` for date fields).\n- `clickup_remove_task_custom_field_value`: Removes/clears the value of a Custom Field from a specific task.\n - Requires: `task_id`, `field_id`.\n\n### Doc Management\n\n**Note:** ClickUp's API for Docs (especially v2, with some operations now using v3) has limitations. Content is primarily handled as Markdown. Advanced formatting or complex embeds might not be fully supported. Direct document deletion via API is not currently supported by ClickUp's V3 /docs endpoint; manage Doc lifecycle through archiving or page manipulation.\n\n- `clickup_search_docs`: Searches for Docs within a Workspace (Team).\n - Requires: `workspace_id`.\n - Optional: `query` (string), `include_archived` (boolean).\n- `clickup_create_doc`: Creates a new Doc.\n - Requires: `workspace_id`, `name`.\n - Optional: `parent` (object with `id` and `type`), `visibility` (string: \"private\", \"workspace\", \"public\"), `create_page` (boolean).\n- `clickup_get_doc_pages`: Retrieves the list of pages within a specific Doc.\n - Requires: `doc_id`.\n- `clickup_create_doc_page`: Creates a new page within a specific Doc.\n - Requires: `workspace_id`, `doc_id`, `name` (page title).\n - Optional: `content` (Markdown), `orderindex` (number, though v3 API may not use it), `parent_page_id` (string), `sub_title` (string), `content_format` (string).\n- `clickup_get_doc_page_content`: Retrieves the content (Markdown) of a specific Doc page.\n - Requires: `workspace_id`, `doc_id`, `page_id`.\n - Optional: `content_format` (string).\n- `clickup_edit_doc_page_content`: Updates the content and/or title of a specific Doc page.\n - Requires: `workspace_id`, `doc_id`, `page_id`, `content` (Markdown).\n - Optional: `title` (string, maps to API 'name'), `sub_title` (string), `content_edit_mode` (string: \"replace\", \"append\", \"prepend\"), `content_format` (string).\n\n### View Management\n\n- `clickup_get_views`: Retrieves all Views for a given parent resource (Team, Space, Folder, or List).\n - Requires: `parent_id` (ID of the parent resource), `parent_type` (string: \"team\", \"space\", \"folder\", or \"list\").\n- `clickup_create_view`: Creates a new View within a Team, Space, Folder, or List.\n - Requires: `parent_id`, `parent_type`, `name` (string: name of the new View), `type` (string: type of the View, e.g., \"list\", \"board\", \"calendar\", \"gantt\").\n - Optional: `grouping`, `divide`, `sorting`, `filters`, `columns`, `team_sidebar`, `settings` (objects defining view configurations).\n- `clickup_get_view_details`: Retrieves details for a specific View.\n - Requires: `view_id`.\n- `clickup_update_view`: Updates an existing View.\n - Requires: `view_id`.\n - Optional: `name` (string), `grouping`, `divide`, `sorting`, `filters`, `columns`, `team_sidebar`, `settings`.\n- `clickup_delete_view`: Deletes a View.\n - Requires: `view_id`.\n- `clickup_get_view_tasks`: Retrieves tasks belonging to a specific View.\n - Requires: `view_id`.\n - Optional: `page` (number: 0-indexed page number for pagination).\n\n## Development\n\n1. Clone the repository:\n ```bash\n git clone \n cd clickup-mcp-server\n ```\n2. Install dependencies:\n ```bash\n npm install\n ```\n3. Create a `.env` file in the root directory and add your `CLICKUP_PERSONAL_TOKEN`:\n ```env\n CLICKUP_PERSONAL_TOKEN=your_actual_personal_api_token_here\n LOG_LEVEL=debug\n ```\n4. Start in development mode (Stdio):\n The server will listen for MCP messages on stdin/stdout.\n\n ```bash\n npm run dev\n ```\n\n This uses `ts-node-dev` to run `src/index.ts`.\n\n5. Build for production:\n\n ```bash\n npm run build\n ```\n\n This compiles TypeScript to `dist/`.\n\n6. Run tests:\n ```bash\n npm test\n ```\n This runs Jest unit tests located in `src/__tests__`. Ensure you have a `.env.test` file (see `src/__tests__/setup.ts`).\n\n### Testing with MCP Inspector\n\nYou can test the server locally using the MCP Inspector:\n\n1. Ensure your `CLICKUP_PERSONAL_TOKEN` is available. You can either:\n - Set it in your shell environment before running the inspector.\n - Set it within the MCP Inspector UI if it provides an option for server environment variables.\n - Have it in your local `.env` file (as `src/index.ts` loads `dotenv`).\n2. Run the Inspector with the server:\n ```bash\n npx @modelcontextprotocol/inspector node --loader ts-node/esm src/index.ts\n ```\n The Inspector UI should launch, allowing you to connect to the server and call its tools.\n\n## Security\n\n- Authenticates using your ClickUp Personal API Token. **Keep this token secure and confidential.** Treat it like a password.\n- The server expects the `CLICKUP_PERSONAL_TOKEN` to be provided via an environment variable by the consuming MCP client or development environment.\n- The configuration system includes logic for an `ENCRYPTION_KEY` and `src/security.ts` has encryption functions, but this is **not currently applied** to the Personal API Token by the `ClickUpService`.\n- No sensitive data (like the token itself) is logged by default with `LOG_LEVEL=info`. Debug level might log more details.\n- Rate limiting for ClickUp API calls is handled by logging remaining requests (see `ClickUpService`).\n\n## Troubleshooting\n\n### Common Issues\n\n1. **Authentication Errors (401 from ClickUp API)**\n\n - Verify your `CLICKUP_PERSONAL_TOKEN` environment variable is correctly set and accessible by the server process.\n - Ensure the token is valid and not revoked in your ClickUp settings.\n - Check server logs for messages from `ClickUpService` regarding authentication.\n\n2. **Rate Limiting by ClickUp API**\n\n - The server logs rate limit information from ClickUp API responses.\n - If rate limits are hit frequently, this indicates high usage. The server itself does not implement queuing or complex backoff beyond what `axios` might do by default.\n\n3. **Server Not Starting / MCP Inspector Connection Issues**\n - Ensure `CLICKUP_PERSONAL_TOKEN` is set.\n - If using `npm run dev`, check for TypeScript or `ts-node-dev` errors in the console.\n - If using MCP Inspector with `node --loader ts-node/esm src/index.ts`, ensure `ts-node` and project dependencies are correctly installed.\n - Check for console errors from `src/index.ts` or `ClickUpService`.\n\n### Getting Server Logs\n\n- When run via `npm run dev` or `npm start`, logs go to the console.\n- If run by an MCP client (like Claude for Desktop), logs are typically managed by that client. For Claude for Desktop, logs can often be found at:\n - Windows: `%USERPROFILE%\\AppData\\Local\\Claude\\Logs\\mcp\\\\.log` (path may vary slightly)\n - macOS: `~/Library/Logs/Claude/mcp/\\.log` (path may vary slightly)\n\n## Support\n\nIf you find this project helpful, consider buying me a coffee to support ongoing development and maintenance.\n\n $\"Buy$ \n\n## License\n\nMIT License - see LICENSE file for details\n# Test pipeline fix\n","url","https://github.com/Nazruden/clickup-mcp-server","githubRepository",{"_133":134,"_135":136,"_137":138,"_139":140,"_33":141,"_142":143,"_148":149,"_150":151,"_153":154},"defaultBranch","main","fullName","Nazruden/clickup-mcp-server","githubTreeId",155025,"language","TypeScript","clickup-mcp-server","owner",{"_144":145,"_146":147},"login","Nazruden","uid","k4xv6plj3v","recentStargazers",0,"spdxLicense",{"_33":152},"MIT License","stargazers",12,"glamaJson",880,"inspectable",true,"integrations",[161],{"_162":163,"_31":169,"_146":170},"brand",{"_164":165,"_33":166,"_167":168},"logoSvgPath","M2 18.439l3.69-2.828c1.961 2.56 4.044 3.739 6.363 3.739 2.307 0 4.33-1.166 6.203-3.704L22 18.405C19.298 22.065 15.941 24 12.053 24 8.178 24 4.788 22.078 2 18.439zM12.04 6.15l-6.568 5.66-3.036-3.52L12.055 0l9.543 8.296-3.05 3.509z","ClickUp","slug","clickup","Enables interaction with ClickUp workspaces, providing tools for task management (creating and updating tasks), team and list management (retrieving teams and lists), and board management (creating boards).","9m4my4ky4l","namespace","npmPackage",{"_33":174,"_175":176},"@nazruden/clickup-server","weeklyDownloads",79,"redditPostExternalId","1ijtfff","scores",{"_181":182,"_183":182,"_184":182},"license",100,"quality","security","simpleIcon","supportedPlatforms",[188,189],"WINDOWS","MACOS","toolCount",5,"9a7p2exf6u","updatedAt","2025-08-11T16:25:34.397397156Z","meta",[197,200,202,209,212,214,217,220,223,226,229,231,234,237,239,241,243,245,247],{"_198":199},"title","ClickUp MCP Server | Glama",{"_201":42,"_33":31},"content",{"_203":204,"_205":206,"_207":208},"href","https://glama.ai/mcp/servers/@Nazruden/clickup-mcp-server","rel","canonical","tagName","link",{"_201":43,"_210":211},"property","og:title",{"_201":42,"_210":213},"og:description",{"_201":215,"_210":216},"https://glama.ai/logo.png","og:logo",{"_201":218,"_210":219},"https://glama.ai/mcp/servers/@Nazruden/clickup-mcp-server/og-image","og:image",{"_201":221,"_210":222},"630","og:image:height",{"_201":224,"_210":225},"1200","og:image:width",{"_201":227,"_210":228},"website","og:type",{"_201":204,"_210":230},"og:url",{"_201":232,"_210":233},"Glama – MCP Hosting Platform","og:site_name",{"_201":235,"_33":236},"summary_large_image","twitter:card",{"_201":232,"_33":238},"twitter:title",{"_201":42,"_33":240},"twitter:description",{"_201":218,"_33":242},"twitter:image",{"_201":221,"_33":244},"twitter:image:height",{"_201":224,"_33":246},"twitter:image:width",{"_248":249},"script:ld+json",{"_250":251,"_252":253},"@context","http://schema.org","@graph",[254],{"_250":255,"_256":257,"_258":259},"https://schema.org","@type","BreadcrumbList","itemListElement",[260,267,271,275],{"_256":261,"_262":263,"_33":264,"_265":266},"ListItem","item","https://glama.ai/","Glama","position",1,{"_256":261,"_262":268,"_33":269,"_265":270},"https://glama.ai/mcp","MCP",2,{"_256":261,"_262":272,"_33":273,"_265":274},"https://glama.ai/mcp/servers","Servers",3,{"_256":261,"_262":204,"_33":43,"_265":276},4,"visitorIsMaintainer",false,"routes/_public/mcp/servers/~namespace/~slug/_pages/_explorer/blob/~branch/~/_route",{"_281":282,"_286":134,"_29":287,"_195":307,"_331":332,"_333":334},"blob",{"_201":283,"_284":285},"# Test environment configuration\nCLICKUP_PERSONAL_TOKEN=test_token_for_unit_tests\nLOG_LEVEL=error\nNODE_ENV=test","fileName",".env.test","branch",{"_85":86,"_87":288,"_13":296,"_124":42,"_125":42,"_126":297,"_131":298,"_155":-5,"_16":156,"_157":158,"_159":301,"_33":43,"_171":145,"_172":304,"_177":178,"_179":305,"_185":-5,"_167":141,"_186":306,"_190":191,"_146":192,"_193":194},{"_89":289,"_112":295,"_96":114},{"_91":290,"_98":291,"_102":292,"_105":293,"_109":294},{"_93":94,"_31":95,"_96":97},{"_93":100,"_31":101,"_96":97},{"_31":104,"_96":97},{"_93":107,"_31":108,"_96":97},{"_31":111,"_96":97},[102,109],[116,117,118,119,120,121,122,123],{"_35":128,"_129":130},{"_133":134,"_135":136,"_137":138,"_139":140,"_33":141,"_142":299,"_148":149,"_150":300,"_153":154},{"_144":145,"_146":147},{"_33":152},[302],{"_162":303,"_31":169,"_146":170},{"_164":165,"_33":166,"_167":168},{"_33":174,"_175":176},{"_181":182,"_183":182,"_184":182},[188,189],[308,310,312,314,316,317,318,320,321,322,323,324,325,326,327,328,329,330],{"_198":309},"MCP Server | Glama",{"_201":311,"_33":31},"Enterprise-grade security, privacy, and features like agents, MCP, prompt templates, and more.",{"_203":313,"_205":206,"_207":208},"https://glama.ai/mcp/servers/@Nazruden/clickup-mcp-server/blob/main/",{"_201":315,"_210":211},"MCP Server",{"_201":311,"_210":213},{"_201":215,"_210":216},{"_201":319,"_210":219},"https://glama.ai/generated-images/og?title=MCP+Server",{"_201":221,"_210":222},{"_201":224,"_210":225},{"_201":227,"_210":228},{"_201":313,"_210":230},{"_201":232,"_210":233},{"_201":235,"_33":236},{"_201":232,"_33":238},{"_201":311,"_33":240},{"_201":319,"_33":242},{"_201":221,"_33":244},{"_201":224,"_33":246},"path","","treeMembers",[335,338,340,341,343,345,347,349,351,353,355,357,359,361,363,365,367,369,370,372,374,376,378,380,382,384,386,388,390,392,394],{"_331":336,"_96":337},".ai","tree",{"_331":339,"_96":337},"bin",{"_331":141,"_96":337},{"_331":342,"_96":337},"clickup_mcp_server.egg-info",{"_331":344,"_96":337},".cursor",{"_331":346,"_96":337},"data",{"_331":348,"_96":337},"docs",{"_331":350,"_96":337},".github",{"_331":352,"_96":337},"public",{"_331":354,"_96":337},"scripts",{"_331":356,"_96":337},"src",{"_331":358,"_96":281},".aijournal",{"_331":360,"_96":281},"CHANGELOG.md",{"_331":362,"_96":281},"docker-compose.yml",{"_331":364,"_96":281},"Dockerfile",{"_331":366,"_96":281},".dockerignore",{"_331":368,"_96":281},".env.example",{"_331":285,"_96":281},{"_331":371,"_96":281},".eslintrc.js",{"_331":373,"_96":281},".gitignore",{"_331":375,"_96":281},"install.sh",{"_331":377,"_96":281},"jest.config.js",{"_331":379,"_96":281},"LICENSE",{"_331":381,"_96":281},"package.json",{"_331":383,"_96":281},"package-lock.json",{"_331":385,"_96":281},"README.md",{"_331":387,"_96":281},"setup.py",{"_331":389,"_96":281},"smithery.yaml",{"_331":391,"_96":281},"tsconfig.build.json",{"_331":393,"_96":281},"tsconfig.json",{"_331":395,"_96":281},"tsconfig.test.json","actionData","errors"]

MCP directory API