How do I install the Milkee skill?

Run npx skillmds@latest add johnalbertini14-glitch/milkee 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: executes scripts, 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?

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

Milkee by johnalbertini14-glitch — Agent Skill

Name: Milkee
Rating: 4.2 (5 reviews)
Author: johnalbertini14-glitch

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. Features smart fuzzy project matching.

File contents

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

---name: milkeedescription: 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.--- # 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) ```bash # 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 ```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 456 --name "Updated" --budget 6000 ``` ### Customers ```bash 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 ```bash 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: ```bash 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

Frequently asked questions