Time Tracking Tools

---

log_time

Record hours on a project.

Writes to: 01. Time Entries

Parameters:

Param	Type	Required	Description
requesting_user_slack_id	string	✅	Always the sender's Slack ID
project	string	✅	Project name (must match exactly)
task	string	✅	Task type — Development, Design, QA, etc.
hours	string	✅	Format: "4h 30m"
date	string		YYYY-MM-DD — defaults to today
notes	string		Optional context
slack_user_id	string		Log for another user — Manager/Owner only
person	string		Name-based lookup (less reliable than slack_user_id)

Business rules:

• Task is always required — VERA will ask if missing
• User can only log for themselves unless Manager/Owner
• When logging for an @mention, use slack_user_id not person
• Returns entry id on success: "Logged 4h on Nike Rebrand (Development) (ID: 42)"

Example:

"Log 4h 30m on Nike Rebrand for development" "Log 2 hours for @alice on Acme project — design"

---

get_time_entries

Retrieve and filter time entries.

Reads from: 01. Time Entries, 02. Projects, 03. Users, 05. Tasks

Parameters:

Param	Type	Description
requesting_user_slack_id	string	Controls what data is returned
slack_user_id	string	Filter by person (Slack ID — preferred)
person	string	Filter by person name
project_name	string	Filter by project
task_name	string	Filter by task type
start_date	string	YYYY-MM-DD — range start
end_date	string	YYYY-MM-DD — range end

Permission rules:

• Owners see all entries
• Managers see entries for their assigned projects
• Users see only their own entries

Note: When querying for an @mention (e.g. "show @alice's time"), always pass slack_user_id rather than person. Name matching can fail if display names differ from stored names.

---

hours_this_week

Sum of hours logged this week for a user.

Reads from: 01. Time Entries

Parameters:

Param	Type	Description
requesting_user_slack_id	string
slack_user_id	string	For querying another user (Manager/Owner)

Week boundaries are calculated in the tenant's configured timezone.

---

edit_entry

Update the hours or notes on a time entry.

Updates: 01. Time Entries (full row rewrite A:H)

Parameters:

Param	Type	Required	Description
requesting_user_slack_id	string	✅
id	integer	✅	Entry ID (from log confirmation or get_time_entries)
new_hours	string		New hours value — format "4h 30m"
new_notes	string		New notes

Permission: Owners can edit any entry. Users can only edit their own.

---

delete_entry

Permanently delete a time entry.

Deletes from: 01. Time Entries

Parameters:

Param	Type	Required	Description
requesting_user_slack_id	string	✅
id	integer	✅	Entry ID to delete

Permission: Owners can delete any entry. Users can only delete their own.

Deletion is permanent. There is no undo. VERA will confirm the action before deleting.