clockify-python-115 0.1.0

clockify-python-115 0.1.0

First release of the independent clockify-python-115 project.

• Complete typed async SDK: 168 operations on 29 resources.
• Read-only MCP server: 60 raw reads and five workflows.
• Zero registered MCP writes.
• Protected authenticated headers, bounded sanitized errors, no write retries,
  and HTTP-date Retry-After support.
• Python 3.11 through 3.14.

This project is not affiliated with, endorsed by, or sponsored by CAKE.com or
Clockify.

Install

uv add clockify-python-115
uv add "clockify-python-115[mcp]"

SDK example

import asyncio
import os

from clockify import ClockifyClient


async def main():
    async with ClockifyClient(api_key=os.environ["CLOCKIFY_API_KEY"]) as client:
        me = await client.users.me()
        print(me.name)


asyncio.run(main())

MCP server

Install the [mcp] extra. Configure one credential and run:

clockify-mcp

The server lists 65 tools. It exposes 60 raw reads and five workflows. It
registers zero writes.

Limitations

• The project is unofficial.
• The MCP server is read-only.
• Some PUT omission rules remain conservative and require full replacement care.
• Future MCP writes require human-approval evidence from two intended hosts.

Artifacts

Two independent builds produced byte-identical files:

File	Size	SHA-256
clockify_python_115-0.1.0-py3-none-any.whl	188,562 bytes	ea85c93fb6108d828576fea9eec6433f48e8ae8210df4d33d317d971d4dfb60c
clockify_python_115-0.1.0.tar.gz	367,153 bytes	259afe53aa3bfc1480211664b21bfd7f535db4f7293edc24899d350a8440905d

For developers

clockify-python-115 provides installed PEP 561 typing, explicit resources,
three-host routing, safe bounded errors, and exact artifact verification.

For Clockify users

Use Python or a read-only MCP client to inspect Clockify users, projects, time
entries, reports, and workspace data. MCP writes remain disabled.