MILKEE Swiss Accounting

Complete MILKEE accounting integration for Swiss businesses. Manage projects, customers, time tracking, tasks, and products. Use when: (1) tracking billable time with start/stop timers, (2) creating/managing projects and customers, (3) recording work entries with descriptions, (4) viewing daily time summaries. Features smart fuzzy project matching.

Security Scan

The skill's code, runtime instructions, and required environment variables are consistent with a MILKEE time‑tracking/accounting integration — nothing obvious or disproportionate was found.

Purpose & Capability

Name/description, SKILL.md, docs, and the included scripts/milkee.py all align: the skill implements project/customer/time/task/product management against the MILKEE API and only requests MILKEE_API_TOKEN and MILKEE_COMPANY_ID which are appropriate for that purpose.

Instruction Scope

Runtime instructions and CLI commands map directly to the functionality in scripts/milkee.py. The skill saves timer state to a file at ~/.milkee_timer (documented and used to persist timer between sessions) — this is expected but means local data persists until stop or manual removal. The SKILL.md and installation docs instruct editing ~/.clawdbot config to provide env vars (expected). No instructions ask the agent to read unrelated system files or exfiltrate data.

Install Mechanism

No install spec is provided (instruction-only distribution) and the package includes a Python script. Nothing is downloaded or executed from remote third‑party URLs during install.

Credentials

The skill requires exactly MILKEE_API_TOKEN and MILKEE_COMPANY_ID — these are reasonable and necessary for API access. Documentation shows example token formatting; treat those values as sensitive. No additional unrelated credentials or config paths are requested.

Persistence & Privilege

always:false and normal autonomous invocation default. The skill only persists a single timer file (~/.milkee_timer) under the user's home directory and does not modify other skills or system-wide agent settings.

Assessment

This package appears coherent for MILKEE integration. Before installing: 1) Verify you trust the author/source and that the API base (https://app.milkee.ch) is correct for your account. 2) Treat MILKEE_API_TOKEN (USER_ID|API_KEY) as sensitive — provide least‑privilege/token that your MILKEE account supports and rotate it if exposed. 3) Be aware the skill writes ~/.milkee_timer containing project id, name, description and start time — remove or secure that file if you need confidentiality. 4) If you will run in a multi-user or production environment, consider running the skill in an isolated account/container and review the included scripts/milkee.py yourself. 5) If you have doubts about provenance (source is 'unknown'), prefer manual code review or run in a sandbox before granting real API credentials.

MILKEE Skill

Complete integration for MILKEE Swiss accounting software. Manage projects, customers, time tracking, tasks, and products.

Features

• ⏱️ Time Tracking – Start/stop timers with fuzzy project matching
• 👥 Customers – Full CRUD operations
• 📋 Projects – Create, update, manage budgets
• ✅ Tasks – Track project tasks
• 📦 Products – Manage billable items

Quick Start

Time Tracking (Main Feature)

# Start timer (smart fuzzy match)
python3 scripts/milkee.py start_timer "Website" "Building authentication"

# Stop timer (auto-logs to MILKEE)
python3 scripts/milkee.py stop_timer

# Show today's times
python3 scripts/milkee.py list_times_today

Projects

python3 scripts/milkee.py list_projects
python3 scripts/milkee.py create_project "My Project" --customer-id 123 --budget 5000
python3 scripts/milkee.py update_project 456 --name "Updated" --budget 6000

Customers

python3 scripts/milkee.py list_customers

# Create with all fields
python3 scripts/milkee.py create_customer "Example AG" \
  --street "Musterstrasse 1" \
  --zip "8000" \
  --city "Zürich" \
  --phone "[phone]" \
  --email "[e-mail]" \
  --website "https://example.ch"

# Update specific fields
python3 scripts/milkee.py update_customer 123 --name "New Name" --phone "[phone]"

Tasks & Products

python3 scripts/milkee.py list_tasks
python3 scripts/milkee.py create_task "Implement feature" --project-id 456

python3 scripts/milkee.py list_products
python3 scripts/milkee.py create_product "Consulting Hour" --price 150

Configuration

Set environment variables:

export MILKEE_API_TOKEN="USER_ID|API_KEY"
export MILKEE_COMPANY_ID="YOUR_COMPANY_ID"

Or configure via your gateway config under skills.entries.milkee.env.

Get Your Credentials

1. Log in to MILKEE → Settings → API
2. Copy your User ID and API Key
3. Format: USER_ID|API_KEY
4. Company ID is shown in Settings

Special Features

Fuzzy Project Matching

When you say "Website", the skill:

1. Fetches all projects from MILKEE
2. Fuzzy-matches using Levenshtein distance
3. Auto-selects the closest match
4. Starts timer on that project

Timer Persistence

• Timer state saved to ~/.milkee_timer
• Survives between sessions
• Auto-calculates elapsed time on stop

Daily Summary

list_times_today shows:

• All time entries for today
• Duration per entry
• Total hours worked

Technical Details

• Language: Python 3.8+
• Dependencies: None (stdlib only)
• Timer File: ~/.milkee_timer (JSON)
• API Docs: https://apidocs.milkee.ch/api

---

Author: xenofex7 | Version: 2.0.0