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.

Audits

Pass

ClawScanPass

Agentic behavior and permission review.

Static analysisPass

Pattern checks against bundled files.

VirusTotalPass

Multi-engine malware detections and file reputation.

Install

openclaw skills install milkee

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 "+41 44 123 45 67" \
  --email "info@example.ch" \
  --website "https://example.ch"

# Update specific fields
python3 scripts/milkee.py update_customer 123 --name "New Name" --phone "+41 44 999 88 77"

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

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

Special Features

Fuzzy Project Matching

When you say "Website", the skill:

Fetches all projects from MILKEE
Fuzzy-matches using Levenshtein distance
Auto-selects the closest match
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