TOOLS.md

Tools Reference — Personal AI Platform

Alle 70+ LLM-Tools mit Beschreibung, Parametern und Beispielen.

Hinweis: Diese Tools werden vom LLM (via OpenRouter) automatisch aufgerufen.
Der Nutzer schreibt natürliche Sprache — das LLM entscheidet, welches Tool passt.

Produktivität

create_reminder

Erstellt eine neue Erinnerung.

Parameter	Typ	Pflicht	Beschreibung
title	string	✅	Titel (z.B. "Müll rausbringen")
datetime_str	string	✅	Datum/Uhrzeit (ISO: YYYY-MM-DDTHH:MM oder "morgen 18:00")
priority	string	❌	high, normal, low

Beispiel: "Erinnere mich morgen um 8 Uhr an den Zahnarzttermin" → create_reminder(title="Zahnarzttermin", datetime_str="morgen 08:00", priority="high")

list_reminders

Listet anstehende Erinnerungen.

Parameter	Typ	Pflicht	Beschreibung
date_filter	string	❌	today, week, all

Beispiel: "Welche Erinnerungen habe ich diese Woche?" → list_reminders(date_filter="week")

create_task

Erstellt eine neue Aufgabe.

Parameter	Typ	Pflicht	Beschreibung
title	string	✅	Titel der Aufgabe
priority	string	❌	high, normal, low
deadline	string	❌	Fälligkeitsdatum (YYYY-MM-DD)

Beispiel: "Füge Aufgabe hinzu: Steuererklärung machen" → create_task(title="Steuererklärung machen", priority="high")

list_tasks

Listet Aufgaben auf.

Parameter	Typ	Pflicht	Beschreibung
status_filter	string	❌	open, done, all

Beispiel: "Zeig meine offenen Aufgaben" → list_tasks(status_filter="open")

complete_task

Markiert Aufgabe als erledigt.

Parameter	Typ	Pflicht	Beschreibung
task_id	string	✅	ID der Aufgabe (8-stelliger Präfix reicht)

Beispiel: "Aufgabe abc12345 ist erledigt" → complete_task(task_id="abc12345")

create_note

Erstellt eine Notiz.

Parameter	Typ	Pflicht	Beschreibung
text	string	✅	Notiztext
category	string	❌	idee, todo, info

Beispiel: "Notiz: Server-Zugangsdaten liegen im Tresor" → create_note(text="Server-Zugangsdaten liegen im Tresor", category="info")

list_notes

Listet die letzten Notizen.

Parameter	Typ	Pflicht	Beschreibung
limit	integer	❌	Anzahl (Standard: 10)

Beispiel: "Zeig meine letzten Notizen" → list_notes(limit=10)

get_status

Systemstatus: offene Tasks, anstehende Reminders, aktuelle Phase.

Beispiel: "Wie ist mein Status?" → get_status()

get_today_summary

Tagesübersicht mit Terminen, Aufgaben, Erinnerungen.

Beispiel: "Was steht heute an?" → get_today_summary()

get_help

Zeigt verfügbare Funktionen.

Beispiel: "Was kannst du alles?" → get_help()

Gesundheit & Schlaf

log_sleep

Speichert Schlafdaten.

Parameter	Typ	Pflicht	Beschreibung
hours	number	✅	Schlafstunden (z.B. 7.5)
quality	integer	✅	Qualität 1-10
bed_time	string	❌	Bettzeit (HH:MM)
wake_time	string	❌	Aufwachzeit (HH:MM)

Beispiel: "Ich habe 7.5 Stunden geschlafen, Qualität 8" → log_sleep(hours=7.5, quality=8)

log_symptom

Protokolliert ein Symptom.

Parameter	Typ	Pflicht	Beschreibung
symptom	string	✅	Symptom (z.B. "Kopfweh")
severity	integer	✅	Stärke 1-10
trigger	string	❌	Auslöser

Beispiel: "Habe Kopfweh, Stärke 6" → log_symptom(symptom="Kopfweh", severity=6)

log_food

Speichert eine Mahlzeit.

Parameter	Typ	Pflicht	Beschreibung
description	string	✅	Beschreibung
meal_type	string	❌	Frühstück, Mittagessen, Abendessen, Snack

Beispiel: "Hatte Müsli mit Banane zum Frühstück" → log_food(description="Müsli mit Banane", meal_type="Frühstück")

log_energy

Protokolliert Energie-Level.

Parameter	Typ	Pflicht	Beschreibung
level	integer	✅	Energie 1-10
focus	integer	❌	Fokus 1-10
mood	integer	❌	Stimmung 1-10

Beispiel: "Energie heute 7, Fokus 8" → log_energy(level=7, focus=8)

log_workout

Speichert ein Workout.

Parameter	Typ	Pflicht	Beschreibung
type	string	✅	gym, push, pull, legs, full, joggen, wandern, radfahren, ebike
duration	integer	❌	Dauer in Minuten
intensity	integer	❌	Intensität 1-10
muscle_groups	string	❌	Muskelgruppen

Beispiel: "War 45 Min joggen, Intensität 7" → log_workout(type="joggen", duration=45, intensity=7)

get_health_report

Gesundheitsübersicht (Schlaf, Symptome, Energie, Workouts).

Parameter	Typ	Pflicht	Beschreibung
days	integer	❌	Zeitraum (Standard: 7)

Beispiel: "Wie war meine Gesundheit diese Woche?" → get_health_report(days=7)

analyze_sleep_quality

Korrelation Raumklima ↔ Schlafqualität.

Parameter	Typ	Pflicht	Beschreibung
days	integer	❌	Zeitraum (Standard: 30)

Beispiel: "Analysiere meinen Schlaf der letzten 30 Tage" → analyze_sleep_quality(days=30)

suggest_sleep_improvements

KI-Schlaf-Verbesserungsvorschläge.

Beispiel: "Wie kann ich besser schlafen?" → suggest_sleep_improvements()

get_optimal_sleep_conditions

Optimale Raumtemperatur/Luftfeuchtigkeit für Schlaf.

Parameter	Typ	Pflicht	Beschreibung
days	integer	❌	Zeitraum (Standard: 60)

Budget

log_expense

Ausgabe speichern.

Parameter	Typ	Pflicht	Beschreibung
amount	number	✅	Betrag in Euro
category	string	✅	essen, transport, unterkunft, etc.
country	string	✅	Land
description	string	❌	Beschreibung

Beispiel: "12.50€ für Mittagessen in Berlin" → log_expense(amount=12.50, category="essen", country="Deutschland")

get_budget_status

Budget-Übersicht (Anzahl Ausgaben, Gesamtbetrag).

Beispiel: "Wie ist mein Budget-Status?" → get_budget_status()

get_expense_analytics

Finanz-Analyse mit Trends, Kategorien, Anomalien.

Parameter	Typ	Pflicht	Beschreibung
days	integer	❌	Zeitraum (Standard: 30)

Beispiel: "Analysiere meine Ausgaben diesen Monat" → get_expense_analytics(days=30)

Intelligenz & Reflexion

get_insights

KI-Analyse: Korrelationen, Trends, Anomalien, Empfehlungen.

Parameter	Typ	Pflicht	Beschreibung
topic	string	❌	weekly, anomalies, tomorrow, recommendations
days	integer	❌	Zeitraum (Standard: 14)

Beispiel: "Zeig mir Insights für diese Woche" → get_insights(topic="weekly")

get_reflection

Reflexion erstellen.

Parameter	Typ	Pflicht	Beschreibung
topic	string	❌	evening, weekly, generate
focus	string	❌	Fokus-Thema

Beispiel: "Tagesreflexion bitte" → get_reflection(topic="evening")

check_habits

Status aller aktiven Gewohnheiten.

Parameter	Typ	Pflicht	Beschreibung
habit_name	string	❌	Gewohnheit für Detail-Ansicht

Beispiel: "Check meine Gewohnheiten" → check_habits()

get_productivity_stats

Produktivitäts-Dashboard: Erledigungsrate, Aufgaben/Tag, Fokus-Score.

Beispiel: "Wie produktiv war ich?" → get_productivity_stats()

get_learning_status

Lern-Tracker: Streak, Themen, Prüfungs-Countdown.

Parameter	Typ	Pflicht	Beschreibung
goal	string	❌	Lernziel-Name

Beispiel: "Wie läuft mein Lernen?" → get_learning_status()

get_social_reminders

Social Tracker: Geburtstage, Kontakt-Check, Activity Score.

Parameter	Typ	Pflicht	Beschreibung
days_ahead	integer	❌	Tage im Voraus (Standard: 30)

Beispiel: "Wer hat bald Geburtstag?" → get_social_reminders(days_ahead=30)

Wissen & Suche

web_search

Internet-Suche.

Parameter	Typ	Pflicht	Beschreibung
query	string	✅	Suchbegriff
num_results	integer	❌	Anzahl (Standard: 5, max: 10)

Beispiel: "Such nach den neuesten Python 3.13 Features" → web_search(query="Python 3.13 neue Features", num_results=5)

fetch_webpage

Webseiten-Inhalt abrufen.

Parameter	Typ	Pflicht	Beschreibung
url	string	✅	Vollständige URL

Beispiel: "Lies den Artikel auf heise.de/..." → fetch_webpage(url="https://heise.de/...")

get_news

Aktuelle Nachrichten.

Parameter	Typ	Pflicht	Beschreibung
topic	string	❌	Thema (z.B. "Technologie")
country	string	❌	Ländercode (Standard: de)

Beispiel: "Gibt es Tech-News?" → get_news(topic="Technologie", country="de")

translate_text

Text übersetzen.

Parameter	Typ	Pflicht	Beschreibung
text	string	✅	Text
target_lang	string	❌	Zielsprache (Standard: de)

Beispiel: "Übersetze 'Hello World' ins Deutsche" → translate_text(text="Hello World", target_lang="de")

wikipedia_search

Wikipedia-Suche.

Parameter	Typ	Pflicht	Beschreibung
query	string	✅	Suchbegriff
lang	string	❌	Sprache (Standard: de)

Beispiel: "Wikipedia: Künstliche Intelligenz" → wikipedia_search(query="Künstliche Intelligenz")

wikipedia_article

Wikipedia-Artikel lesen.

Parameter	Typ	Pflicht	Beschreibung
title	string	✅	Exakter Artikel-Titel
lang	string	❌	Sprache (Standard: de)

on_this_day

Historische Ereignisse von heute.

Beispiel: "Was ist heute passiert?" → on_this_day()

search_memory

Agent-Gedächtnis durchsuchen.

Parameter	Typ	Pflicht	Beschreibung
query	string	✅	Suchbegriff

Beispiel: "Was weißt du über meine Arbeit?" → search_memory(query="Arbeit")

add_memory

Erkenntnis speichern.

Parameter	Typ	Pflicht	Beschreibung
content	string	✅	Inhalt
category	string	✅	preference, behavior, health, work

update_user_info

Benutzer-Info aktualisieren.

Parameter	Typ	Pflicht	Beschreibung
key	string	✅	Schlüssel (z.B. user_location)
value	string	✅	Neuer Wert

Smart Home (Home Assistant)

control_ha_light

Lampe steuern.

Parameter	Typ	Pflicht	Beschreibung
entity	string	✅	Entity-ID (z.B. light.wohnzimmer)
action	string	✅	on, off, set_brightness
brightness	integer	❌	Helligkeit 0-255 (nur bei set_brightness)

Beispiel: "Mach das Licht im Wohnzimmer an" → control_ha_light(entity="light.wohnzimmer", action="on")

get_ha_state

Entity-Zustand abfragen.

Parameter	Typ	Pflicht	Beschreibung
entity	string	✅	Entity-ID

Beispiel: "Wie warm ist es im Schlafzimmer?" → get_ha_state(entity="sensor.schlafzimmer_temperature")

run_ha_script

HA-Script ausführen.

Parameter	Typ	Pflicht	Beschreibung
script_name	string	✅	Script-Name

discover_smart_home

Smart-Home-Geräte entdecken und analysieren.

get_room_temperature

Raumtemperatur auslesen.

Parameter	Typ	Pflicht	Beschreibung
room	string	❌	schlafzimmer, wohnzimmer, kueche

Personalisierung & Einstellungen

track_mood

Stimmung speichern.

Parameter	Typ	Pflicht	Beschreibung
rating	integer	✅	Stimmung 1-10
note	string	❌	Grund/Auslöser

Beispiel: "Ich fühle mich heute 8/10" → track_mood(rating=8)

save_thought

Gedanken speichern mit Tags.

Parameter	Typ	Pflicht	Beschreibung
text	string	✅	Gedanke
tags	string	❌	Komma-getrennt: idee, sorge, erkenntnis, frage

Beispiel: "Idee: Einen Blog über KI-Agenten starten" → save_thought(text="Blog über KI-Agenten starten", tags="idee")

quick_action

Vordefinierte Aktion ausführen.

Parameter	Typ	Pflicht	Beschreibung
action_name	string	✅	gute_nacht, aufstehen, kino_abend, putzen, fokus_modus, reise_vorbereitung, entspannung

Beispiel: "Gute Nacht" → quick_action(action_name="gute_nacht")

set_phase

Aktuelle Lebensphase setzen.

Parameter	Typ	Pflicht	Beschreibung
phase_name	string	✅	Phasen-Name

set_vacation_mode

Urlaubsmodus.

Parameter	Typ	Pflicht	Beschreibung
enabled	boolean	✅	Aktivieren/Deaktivieren
timezone	string	❌	Urlaubs-Zeitzone
return_date	string	❌	Rückreise (YYYY-MM-DD)

Beispiel: "Ich bin im Urlaub bis 15. Juni" → set_vacation_mode(enabled=true, return_date="2026-06-15")

get_settings

Einstellungen anzeigen.

Parameter	Typ	Pflicht	Beschreibung
category	string	❌	Benachrichtigungen, Smart Home, Agent, Standort & Urlaub, Ziele & Gewohnheiten

Beispiel: "Zeig meine Einstellungen" → get_settings()

set_setting

Einstellung ändern.

Parameter	Typ	Pflicht	Beschreibung
key	string	✅	z.B. language, timezone, briefing_time
value	string	✅	Neuer Wert

Beispiel: "Ändere Sprache auf Englisch" → set_setting(key="language", value="en")

get_briefing_time

Aktuelle Briefing-Zeit anzeigen.

get_weather

Wetter abrufen.

Parameter	Typ	Pflicht	Beschreibung
city	string	❌	Stadt (Standard: aus Config)

Beispiel: "Wie ist das Wetter in München?" → get_weather(city="München")

get_todays_events

Heutige Kalender-Termine.

set_phase

Tagesphase setzen (morning, active, evening, sleeping).

---

Kontakte & Familie

add_contact

Neuen Kontakt speichern.

Parameter	Typ	Pflicht	Beschreibung
name	string	✅	Name des Kontakts
birthday	string	❌	Geburtsdatum (MM-DD oder YYYY-MM-DD)
relationship	string	❌	Beziehung (z.B. „Familie", „Freund")
notes	string	❌	Notizen zum Kontakt

Beispiel: „Speichere Anna, Geburtstag am 15.03" → add_contact(name="Anna", birthday="03-15")

list_contacts

Alle gespeicherten Kontakte auflisten.

Parameter	Typ	Pflicht	Beschreibung
filter	string	❌	birthdays, recent, all

Beispiel: „Wer hat bald Geburtstag?" → list_contacts(filter="birthdays")

send_to_contact

Nachricht an einen Kontakt über den Agent senden.

Parameter	Typ	Pflicht	Beschreibung
contact_name	string	✅	Name des Kontakts
message	string	✅	Nachrichtentext

Beispiel: „Schick Anna: Bin in 10 Min da" → send_to_contact(contact_name="Anna", message="Bin in 10 Min da")

set_contact_approval

Genehmigung für Kontakt-Kommunikation setzen.

Parameter	Typ	Pflicht	Beschreibung
contact_name	string	✅	Kontakt-Name
approved	boolean	✅	Genehmigt/Blockiert

---

Pflanzen-Tracker

add_plant

Neue Pflanze registrieren.

Parameter	Typ	Pflicht	Beschreibung
name	string	✅	Pflanzenname
type	string	❌	Pflanzenart (z.B. „Monstera")
watering_interval_days	integer	❌	Gieß-Intervall in Tagen
location	string	❌	Standort
notes	string	❌	Pflegehinweise

Beispiel: „Neue Pflanze: Monstera im Wohnzimmer" → add_plant(name="Monstera", location="Wohnzimmer")

water_plant

Pflanze als gegossen markieren.

Parameter	Typ	Pflicht	Beschreibung
plant_name	string	✅	Pflanzenname

Beispiel: „Monstera gegossen" → water_plant(plant_name="Monstera")

list_plants

Alle Pflanzen und Gieß-Status auflisten.

watering_schedule

Gießplan für alle Pflanzen.

plant_tips

Pflegetipps für eine bestimmte Pflanze.

Parameter	Typ	Pflicht	Beschreibung
plant_name	string	❌	Pflanzenname (sonst alle)

---

Timer

timer_start

Timer starten.

Parameter	Typ	Pflicht	Beschreibung
duration_minutes	integer	✅	Dauer in Minuten
label	string	❌	Bezeichnung (z.B. „Pasta")

Beispiel: „Timer 10 Minuten Pasta" → timer_start(duration_minutes=10, label="Pasta")

timer_status

Aktive Timer anzeigen.

---

Alexa (via Home Assistant)

alexa_speak

Text über Alexa/Echo ausgeben.

Parameter	Typ	Pflicht	Beschreibung
text	string	✅	Auszusprechender Text
device	string	❌	Gerätename (Standard: alle)

Beispiel: „Sag über Alexa: Essen ist fertig" → alexa_speak(text="Essen ist fertig")

alexa_announce

Durchsage auf allen Echo-Geräten.

Parameter	Typ	Pflicht	Beschreibung
message	string	✅	Durchsagentext

alexa_music

Musikwiedergabe steuern.

Parameter	Typ	Pflicht	Beschreibung
action	string	✅	play, pause, next, previous
query	string	❌	Suchbegriff (bei play)

alexa_volume

Lautstärke einstellen.

Parameter	Typ	Pflicht	Beschreibung
level	integer	✅	Lautstärke 0-100
device	string	❌	Gerätename

---

Smart Buttons

setup_button

Smart Button konfigurieren.

Parameter	Typ	Pflicht	Beschreibung
button_name	string	✅	Button-Name
action	string	✅	Aktion (z.B. goodnight, wakeup)
device_entity	string	❌	HA-Entity-ID

Beispiel: „Konfiguriere Nacht-Button" → setup_button(button_name="Nacht-Button", action="goodnight")

list_buttons

Alle konfigurierten Buttons auflisten.

remove_button

Button entfernen.

goodnight_routine

Gute-Nacht-Routine ausführen (Licht dimmen, Türen prüfen, etc.).

wakeup_routine

Aufwach-Routine ausführen (Licht langsam an, Briefing vorbereiten).

---

Präsenz & Anwesenheit

am_i_home

Prüft ob der Nutzer zuhause ist (via HA Presence).

get_presence_summary

Anwesenheits-Übersicht (wer ist zuhause, seit wann).

---

Kalender & Termine (erweitert)

get_todays_events

Heutige Termine aus allen verknüpften Kalendern.

get_calendar_status

Kalender-Status und anstehende Events.

Parameter	Typ	Pflicht	Beschreibung
calendar_provider	string	❌	google, ical, ha

add_calendar

Neues Kalender-Event erstellen.

Parameter	Typ	Pflicht	Beschreibung
title	string	✅	Event-Titel
datetime_str	string	✅	Datum & Uhrzeit
duration_minutes	integer	❌	Dauer in Minuten
calendar_provider	string	❌	Kalender-Provider

sync_calendars_llm

Kalender manuell synchronisieren.

schedule_appointment

Termin mit natürlicher Sprache vereinbaren.

Parameter	Typ	Pflicht	Beschreibung
description	string	✅	Terminbeschreibung
preferred_time	string	❌	Bevorzugte Zeit

---

Gesundheit (erweitert)

get_health_digest

Wöchentlicher Gesundheitsbericht mit Trends und Empfehlungen.

Parameter	Typ	Pflicht	Beschreibung
days	integer	❌	Zeitraum (Standard: 7)

get_health_score

Gesundheits-Score 0-100 basierend auf Schlaf, Bewegung, Ernährung.

---

Workout (erweitert)

analyze_workout

Workout-Daten analysieren (Fortschritt, Trends).

Parameter	Typ	Pflicht	Beschreibung
days	integer	❌	Zeitraum (Standard: 30)

workout_summary

Training-Zusammenfassung für einen Zeitraum.

check_overtraining

Übertraining-Risiko prüfen.

suggest_recovery

Erholungs-Empfehlungen basierend auf Trainingsdaten.

analyze_workout_impact

Auswirkung von Training auf Schlaf/Energie analysieren.

---

Einstellungen (erweitert)

get_locale_settings

Sprach- und Regionseinstellungen anzeigen.

set_locale

Sprache/Region ändern.

Parameter	Typ	Pflicht	Beschreibung
language	string	❌	de, en
timezone	string	❌	z.B. Europe/Berlin

set_personality

Antwort-Persönlichkeit des Agenten anpassen.

Parameter	Typ	Pflicht	Beschreibung
style	string	✅	kurz, normal, ausführlich
emoji_level	string	❌	viele, normal, keine

preview_personality

Vorschau der aktuellen Persönlichkeitseinstellungen.

apply_behavior_profile

Verhaltensprofil anwenden (z.B. „Business", „Casual").

Parameter	Typ	Pflicht	Beschreibung
profile_name	string	✅	Profilname

list_behavior_profiles

Verfügbare Verhaltensprofile auflisten.

set_custom_message

Benutzerdefinierte Nachrichtenvorlage speichern.

Parameter	Typ	Pflicht	Beschreibung
trigger	string	✅	Auslöser (z.B. „morning_greeting")
text	string	✅	Nachrichtentext

list_custom_messages

Benutzerdefinierte Nachrichten auflisten.

set_notification_preference

Benachrichtigungskanal konfigurieren.

Parameter	Typ	Pflicht	Beschreibung
channel	string	✅	telegram, email, alexa
feature	string	✅	Feature (z.B. „reminders")
enabled	boolean	✅	Aktiviert/Deaktiviert

get_notification_status

Benachrichtigungseinstellungen anzeigen.

apply_schedule_preset

Zeitplan-Vorlage anwenden.

Parameter	Typ	Pflicht	Beschreibung
preset_name	string	✅	Name der Vorlage

list_schedule_presets

Verfügbare Zeitplan-Vorlagen auflisten.

set_vacation

Urlaubsmodus mit Aufgabenübergabe.

add_vacation_task

Aufgabe für Urlaubszeit hinzufügen.

cancel_vacation

Urlaub vorzeitig beenden.

vacation_status

Aktuellen Urlaubsstatus anzeigen.