MILKEE Swiss Accounting

通过 Python CLI 脚本调用 MILKEE API，提供可计费工时的开始/停止计时（含模糊项目匹配与本地计时器状态）、今日工时汇总，以及客户、项目、任务、产品的创建、查询与更新。需配置 MILKEE_API_TOKEN 与 MILKEE_COMPANY_ID，仅依赖 Python 3 标准库。

xenofex7

热度 71.79

最近更新 2026-05-11 15:48:53

分类：自动化依赖：代码执行 / 第三方 API / 读写文件应用场景：任务管理 / 工作流 / 财务 / API 集成

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add milkee

Metadata

name: milkee
description: 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.
metadata: {"openclaw":{"requires":{"env":["MILKEE_API_TOKEN","MILKEE_COMPANY_ID"]}}}

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