MaxOstrowski/clockodo-mcp
If you are the rightful owner of clockodo-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.
Clockodo MCP Server is designed to interface with the Clockodo API, providing a streamlined method for managing time tracking data without the need for webhooks.
Clockodo MCP Server
This is an MCP server for the clockodo API, no webhooks.
Usage
To run the server:
python -m clockodo_mcp
To inspect the endpoints use:
npx -y @modelcontextprotocol/inspector
The datamodel for the payload was generated using
datamodel-codegen --input openapi.yaml --output clockodo_mcp/models.py --output-model-type pydantic_v2.BaseModel
with the openapi.yaml that was provided by clockodo. (use datmodel-codegen >= 0.4.0)
Known problems:
datamodel-codegen is used and some enums lose their names (CustomerColor), bugreport is open
I do not yet know how to use the changeRequests to delete or change an entry
for get_subproject the sort parameter might be broken:
curl -X GET -H "X-ClockodoApiUser: $CLOCKODO_API_USER" -H "X-ClockodoApiKey: $CLOCKODO_API_KEY" -H "X-Clockodo-External-Application: $CLOCKODO_EXTERNAL_APP" "https://my.clockodo.com/api/v3/subprojects?sort=id
does not work while all other endpoints need a list of sortings as parameters and work like
curl -X GET -H "X-ClockodoApiUser: $CLOCKODO_API_USER" -H "X-ClockodoApiKey: $CLOCKODO_API_KEY" -H "X-Clockodo-External-Application: $CLOCKODO_EXTERNAL_APP" "https://my.clockodo.com/api/v3/customers?sort=id"