How do I install the Milkee skill?

Run npx skillmds add majiayu000/milkee-2 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Milkee safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Milkee?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Milkee free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Milkee?

majiayu000 (@majiayu000) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Milkee by majiayu000 — Agent Skill

Name: Milkee
Rating: 4.2 (5 reviews)
Author: majiayu000

Milkee

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, (5) managing tasks and products. Features fuzzy project matching, persistent timer state, auto-calculated hours/minutes, and full CRUD operations. Requires MILKEE_API_TOKEN and MILKEE_COMPANY_ID.

majiayu000 04fdaf5 2 files · 4.4 KB Updated Sep 9, 2026 567 repo stars

File contents

MILKEE Accounting Skill

Swiss accounting platform integration for time tracking, project management, customer relations, tasks, and products.

Quick Start

See configuration.md to set up:

MILKEE_API_TOKEN (format: USER_ID|API_KEY)
MILKEE_COMPANY_ID (from MILKEE URL)

Then run commands below using scripts/milkee.py

Core Commands

Time Tracking (Primary Feature)

# Start timer (auto-matches project name via fuzzy matching)
python3 scripts/milkee.py start_timer "Website" "Implementing authentication module"

# Stop timer (auto-calculates hours/minutes, uploads to MILKEE)
python3 scripts/milkee.py stop_timer

# Show today's time entries
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 7478 --name "New Name" --budget 6000

Customers

python3 scripts/milkee.py list_customers
python3 scripts/milkee.py create_customer "ACME Corp" --city "Zürich"
python3 scripts/milkee.py update_customer 123 --name "ACME AG"

Tasks

python3 scripts/milkee.py list_tasks --project-id 7478
python3 scripts/milkee.py create_task "Implement Auth" --project-id 7478
python3 scripts/milkee.py update_task 456 --name "Updated Task"

Products

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

Features

✅ Smart Fuzzy Matching: "Milkee" → "Milkee Company AG" (auto-selects closest project) ✅ Timer Persistence: State saved to ~/.milkee_timer between sessions ✅ Auto-Calculation: Elapsed time computed to hours/minutes ✅ Full CRUD: Projects, customers, tasks, products ✅ Billable Time Tracking: Daily summaries with total hours ✅ No External Dependencies: Uses Python stdlib only

How Fuzzy Matching Works

User says: start_timer "website"
Skill fetches all projects from MILKEE
Uses Levenshtein distance to find best match
Auto-starts timer on highest-scoring project

Example: "website" matches "Website Redesign Project" with 96.5% confidence

Bundled Resources

scripts/milkee.py: CLI tool (300 lines, no dependencies)
references/configuration.md: Setup + troubleshooting
references/api-endpoints.md: Full API reference

See these files for:

Detailed configuration instructions
API endpoint documentation
Error handling guide
Security best practices

Official Documentation

For complete API reference, see:

MILKEE API Docs: https://apidocs.milkee.ch/api
Projects: https://apidocs.milkee.ch/api/resources/projects.html
Customers: https://apidocs.milkee.ch/api/resources/customers.html
Time Entries: https://apidocs.milkee.ch/api/resources/times.html
Tasks: https://apidocs.milkee.ch/api/resources/tasks.html
Products: https://apidocs.milkee.ch/api/resources/products.html
Authentication: https://apidocs.milkee.ch/api/authentifizierung.html

---name: milkee-2description: 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, (5) managing tasks and products. Features fuzzy project matching, persistent timer state, auto-calculated hours/minutes, and full CRUD operations. Requires MILKEE_API_TOKEN and MILKEE_COMPANY_ID.--- # MILKEE Accounting Skill Swiss accounting platform integration for time tracking, project management, customer relations, tasks, and products. ## Quick Start See [configuration.md](references/configuration.md) to set up: - `MILKEE_API_TOKEN` (format: `USER_ID|API_KEY`) - `MILKEE_COMPANY_ID` (from MILKEE URL) Then run commands below using `scripts/milkee.py` ## Core Commands ### Time Tracking (Primary Feature) ```bash # Start timer (auto-matches project name via fuzzy matching) python3 scripts/milkee.py start_timer "Website" "Implementing authentication module" # Stop timer (auto-calculates hours/minutes, uploads to MILKEE) python3 scripts/milkee.py stop_timer # Show today's time entries python3 scripts/milkee.py list_times_today ``` ### Projects ```bash 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 7478 --name "New Name" --budget 6000 ``` ### Customers ```bash python3 scripts/milkee.py list_customers python3 scripts/milkee.py create_customer "ACME Corp" --city "Zürich" python3 scripts/milkee.py update_customer 123 --name "ACME AG" ``` ### Tasks ```bash python3 scripts/milkee.py list_tasks --project-id 7478 python3 scripts/milkee.py create_task "Implement Auth" --project-id 7478 python3 scripts/milkee.py update_task 456 --name "Updated Task" ``` ### Products ```bash python3 scripts/milkee.py list_products python3 scripts/milkee.py create_product "Consulting Hour" --price 150 python3 scripts/milkee.py update_product 789 --price 175 ``` ## Features ✅ **Smart Fuzzy Matching**: "Milkee" → "Milkee Company AG" (auto-selects closest project) ✅ **Timer Persistence**: State saved to `~/.milkee_timer` between sessions ✅ **Auto-Calculation**: Elapsed time computed to hours/minutes ✅ **Full CRUD**: Projects, customers, tasks, products ✅ **Billable Time Tracking**: Daily summaries with total hours ✅ **No External Dependencies**: Uses Python stdlib only ## How Fuzzy Matching Works 1. User says: `start_timer "website"` 2. Skill fetches all projects from MILKEE 3. Uses Levenshtein distance to find best match 4. Auto-starts timer on highest-scoring project **Example**: "website" matches "Website Redesign Project" with 96.5% confidence ## Bundled Resources - **scripts/milkee.py**: CLI tool (300 lines, no dependencies) - **references/configuration.md**: Setup + troubleshooting - **references/api-endpoints.md**: Full API reference See these files for: - Detailed configuration instructions - API endpoint documentation - Error handling guide - Security best practices ## Official Documentation For complete API reference, see: - **MILKEE API Docs**: https://apidocs.milkee.ch/api - **Projects**: https://apidocs.milkee.ch/api/resources/projects.html - **Customers**: https://apidocs.milkee.ch/api/resources/customers.html - **Time Entries**: https://apidocs.milkee.ch/api/resources/times.html - **Tasks**: https://apidocs.milkee.ch/api/resources/tasks.html - **Products**: https://apidocs.milkee.ch/api/resources/products.html - **Authentication**: https://apidocs.milkee.ch/api/authentifizierung.html

Frequently asked questions