CLAUDE.md•1.31 kB
- ClickUp api documentation is available here: https://developer.clickup.com/reference/gettasks
- Think about api limits. ClickUp allows 100 api calls per minute per user. A typical workflow must not exceed that.
- Implement caching by using a global variable and setting it to null after a setTimeout with GLOBAL_REFRESH_INTERVAL. The ClickUp Api limit resets after a minute, so we usually don't need to cache longer than a minute.
- Cache promises, not results, to prevent race conditions when multiple concurrent calls happen before the first completes (see getAllTeamMembers, getCurrentUser, getTaskSearchIndex, getSpaceSearchIndex patterns).
- Use "npm run build" to compile the typescript for validation.
- Use "npm run cli" to test mcp calls.
- Use console.error to prevent writing log messages to stdout.
- DXT manifest.json spec is at https://github.com/anthropics/dxt/blob/main/README.md - update tools section when adding new MCP tools.
- Update the CHANGELOG.md when changing or implementing a new feature.
- Backwards compatibility does not matter, an LLM will understand new parameters.
- Mention ID's, not just names, when outputting references. for example "User: Username (user_id: 12345)"
- You can use ClickUp List 4500611 (Marco Test) to test new mcp calls. (even destructive update calls)