Fritto MCP Server

Server Status: ⚡ Ready

The MCP server is running and ready to accept connections.

🔌 How to Connect

Method 1: OAuth 2.0 (Recommended)

Use OAuth for secure, user-specific authentication with automatic token refresh:

For Claude Code CLI:

claude mcp add --transport http fritto_oauth https://tt-feature-dev-mcp.i.stein-pilz.com/mcp

For Claude Desktop (config file):

{
  "mcpServers": {
    "fritto": {
      "url": "https://tt-feature-dev-mcp.i.stein-pilz.com/mcp"
    }
  }
}

Method 2: API Token (Personal Access Token)

Use your Fritto API token for simple, stateless authentication:

1. Get your API Token from Fritto:

Log into Fritto web interface
Navigate to Settings → API Keys
Generate a new API key
Copy the key (format: guid.secret)

2. Configure your AI assistant:

For Claude Code CLI:

claude mcp add --transport http fritto_pat https://tt-feature-dev-mcp.i.stein-pilz.com/mcp --header "X-Api-Key: <PAT>"

For Claude Desktop (config file):

{
  "mcpServers": {
    "fritto": {
      "url": "https://tt-feature-dev-mcp.i.stein-pilz.com/mcp",
      "headers": {
        "X-Api-Key": "your-api-key-here"
      }
    }
  }
}

️ Available Tools

Quick Navigation

Time Tracking

log_time list_projects get_time_records get_tracked_time validate_day update_time_record delete_time_record

Reports

get_own_time_reports get_all_time_reports export_time_reports_json export_time_reports_csv export_time_reports_xlsx

User Management

list_users get_user create_user update_user delete_user change_user_status

Common Patterns:

Date format: YYYY-MM-DD (e.g., 2025-10-21)
Time input: Hours as decimal (e.g., 1.5 = 1 hour 30 minutes)
Approval status: 0=Draft, 1=Submitted, 2=Approved, 3=Rejected
Group by: 0=Employee, 1=Project, 2=Employee Group, 3=Jira Issue

log_time

Log work hours to a TimeTracker project. Log your own time or (with permission) log time on behalf of another user.

Parameters

Parameter	Type	Required	Description
`projectId`	string (UUID)	Yes	UUID of the project to log time to
`hours`	number	Yes	Hours worked (decimal, 0.01-24 range)
`date`	string	Yes	Date in YYYY-MM-DD format
`taskUrl`	string (URL)	No	Full URL of the task/issue/ticket
`description`	string	No	Work description (max 1024 characters)
`userId`	string (UUID)	No	User UUID to log time on behalf of (requires TrackOnBehalf permission)

Sample Prompt (Own Time)

Log 2.5 hours to project TimeTracker Development for today,
working on ticket TT-123 with description "Implemented new feature"

Sample Prompt (On Behalf)

Log 8 hours for John Doe on 2025-10-21 to project Internal Meeting

Sample Response

✓ Successfully logged 2.5 hours
Logged for: yourself
Project: TimeTracker Development (Steinpilz)
Date: 2025-10-21
Task: https://steinpilz.atlassian.net/browse/TT-123
Description: Implemented new feature

Time record ID: f1e2d3c4-b5a6-7890-fedc-ba0987654321
Concurrency stamp: 638abc...

list_projects

List all projects assigned to you or (with permission) to another user. Returns project IDs, names, client IDs, and client names. Use the Client ID to filter time reports by client.

Parameters

Parameter	Type	Required	Description
`userId`	string (UUID)	No	User UUID to list projects on behalf of (requires TrackOnBehalf permission)

Sample Prompt (Own Projects)

Show me my assigned projects

Sample Prompt (On Behalf)

List projects for john.doe@example.com

Sample Response

Found 3 assigned project(s) for you:

┌────────────────────────────────────────┬──────────────────────────┬────────────────────────────────────────┬──────────────────────────┐
│ Project ID                             │ Project Name             │ Client ID                              │ Client Name              │
├────────────────────────────────────────┼──────────────────────────┼────────────────────────────────────────┼──────────────────────────┤
│ a1b2c3d4-e5f6-7890-abcd-ef1234567890   │ TimeTracker Development  │ c1d2e3f4-a5b6-7890-abcd-ef1234567890   │ Steinpilz                │
│ b2c3d4e5-f6a7-8901-bcde-f12345678901   │ Internal Meeting         │ c1d2e3f4-a5b6-7890-abcd-ef1234567890   │ Steinpilz                │
│ c3d4e5f6-a7b8-9012-cdef-123456789012   │ Customer Support         │ d2e3f4a5-b6c7-8901-bcde-f12345678901   │ External Client          │
└────────────────────────────────────────┴──────────────────────────┴────────────────────────────────────────┴──────────────────────────┘

Use the Project ID when logging time with the log_time tool.
Use the Client ID to filter time reports by client.

get_time_records

Get time records for a date range. View your own time or (with permission) view time for another user.

Parameters

Parameter	Type	Required	Description
`from`	string	Yes	Start date in YYYY-MM-DD format
`to`	string	Yes	End date in YYYY-MM-DD format
`userId`	string (UUID)	No	User UUID to query time records on behalf of (requires TrackOnBehalf permission)

Sample Prompt (Own Time)

Show my time records for last week

Sample Prompt (On Behalf)

Get time records for John Doe from 2025-10-01 to 2025-10-31

Sample Response

Time Records for yourself
Period: 2025-10-01 to 2025-10-07

Summary: 5 day(s), 12 record(s), 40.00 total hours

Date: 2025-10-01 | Status: Approved | Total: 8.00 hours (480 minutes) | Records: 2

  1. TimeTracker Development (Steinpilz)
     Time: 6.00 hours (360 minutes)
     ID: a1b2c3d4-e5f6-7890-abcd-ef1234567890
     Concurrency stamp: 638abc...
     Description: Feature implementation
     Task: https://steinpilz.atlassian.net/browse/TT-123

get_tracked_time

Gets total time logged for a specific task URL. Useful to check how much time has been logged to a ticket/issue.

Parameters

Parameter	Type	Required	Description
`taskUrl`	string (URL)	Yes	Full URL of the task/issue/ticket

Sample Prompt

How much time has been logged to ticket TT-123?

Sample Response

Task: https://steinpilz.atlassian.net/browse/TT-123
Total time logged: 12.50 hours (750 minutes)

validate_day

Check if a specific date is editable (not locked by administrator). Check for yourself or (with permission) check on behalf of another user.

Parameters

Parameter	Type	Required	Description
`date`	string	Yes	Date in YYYY-MM-DD format
`userId`	string (UUID)	No	User UUID to validate on behalf of (requires TrackOnBehalf permission)

Sample Prompt (Own)

Can I log time for September 15th?

Sample Prompt (On Behalf)

Can Jane Smith log time for 2025-10-01?

Sample Response (Editable)

✓ Date 2025-10-21 is editable for yourself. You can log time for this date.

Sample Response (Locked)

✗ Date 2025-09-15 is locked for yourself and cannot be edited.
Reason: Period closed for September 2025

update_time_record

Update an existing time record. Modify your own time or (with permission) modify time on behalf of another user. Pre-fetches latest data before updating to ensure consistency.

Parameters

Parameter	Type	Required	Description
`timeRecordId`	string (UUID)	Yes	UUID of the time record to update
`projectId`	string (UUID)	Yes	UUID of the project
`hours`	number	Yes	Updated hours (0.01667-24 range)
`date`	string	Yes	Date in YYYY-MM-DD format
`originalDate`	string	No	Current date of the record (YYYY-MM-DD). Required when changing date if concurrencyStamp not provided
`taskUrl`	string (URL)	No	Task URL
`description`	string	No	Work description (max 1024 characters)
`concurrencyStamp`	string	No	For optimistic locking. If not provided, tool fetches latest stamp automatically
`userId`	string (UUID)	No	User UUID to update time on behalf of (requires TrackOnBehalf permission)

Sample Prompt (Own Time)

Update my time record from today to 3 hours instead of 2

Sample Prompt (On Behalf)

Update John Doe's time record f1e2d3c4-... to 8 hours

Sample Response

Successfully updated time record
Updated for: yourself

Date: 2025-10-21
Project: TimeTracker Development (Steinpilz)
Time: 3.00 hours (180 minutes)
Description: Updated description

Time record ID: f1e2d3c4-e5f6-7890-abcd-ef1234567890
Concurrency stamp: 638abc...
Day Status: Draft

delete_time_record

Delete a time record by its UUID. Delete your own time or (with permission) delete time on behalf of another user. This action cannot be undone.

Parameters

Parameter	Type	Required	Description
`timeRecordId`	string (UUID)	Yes	UUID of the time record to delete
`userId`	string (UUID)	No	User UUID to delete time on behalf of (requires TrackOnBehalf permission)

Sample Prompt (Own Time)

Delete my duplicate time entry from today

Sample Prompt (On Behalf)

Delete Jane Smith's time record a1b2c3d4-e5f6-7890-abcd-ef1234567890

Sample Response

Successfully deleted time record with ID: a1b2c3d4-e5f6-7890-abcd-ef1234567890
Deleted for: yourself

get_own_time_reports

Gets aggregated time reports for your own tracked time with capacity, tracked hours, and billable hours.

Parameters

Parameter	Type	Required	Description
`from`	string	Yes	Start date in YYYY-MM-DD format
`to`	string	Yes	End date in YYYY-MM-DD format
`clientIds`	array of UUIDs	No	Filter by clients
`projectIds`	array of UUIDs	No	Filter by projects
`approvalStatuses`	array of numbers	No	Filter by status (0=Draft, 1=Submitted, 2=Approved, 3=Rejected)
`jiraIssueUrls`	array of strings	No	Filter by Jira issue URLs or keys (max 100)
`groupBy`	number	No	0=Employee, 1=Project, 2=Employee Group, 3=Jira Issue

Sample Prompt

Show my time report for October grouped by project

Sample Response

Time Report for 2025-10-01 to 2025-10-31
Filters: Group by: Project

📊 TimeTracker Development (Steinpilz)
   Tracked: 120.00 hours (7200 minutes)
   Billable: 120.00 hours (7200 minutes)

📊 Internal Meeting (Steinpilz)
   Tracked: 16.00 hours (960 minutes)
   Billable: 0.00 hours (0 minutes)

--- Summary ---
Total Items: 2
Total Tracked: 136.00 hours (8160 minutes)
Total Billable: 120.00 hours (7200 minutes)

get_all_time_reports

Gets aggregated time reports for all users (manager/admin view). Requires manager/admin permissions.

Parameters

Parameter	Type	Required	Description
`from`	string	Yes	Start date in YYYY-MM-DD format
`to`	string	Yes	End date in YYYY-MM-DD format
`userIds`	array of UUIDs	No	Filter by users
`employeeGroupIds`	array of UUIDs	No	Filter by employee groups
`clientIds`	array of UUIDs	No	Filter by clients
`projectIds`	array of UUIDs	No	Filter by projects
`approvalStatuses`	array of numbers	No	Filter by approval status
`jiraIssueUrls`	array of strings	No	Filter by Jira issue URLs/keys (max 100)
`groupBy`	number	No	Grouping dimension

Sample Prompt

Show team time report for October grouped by employee

Sample Response

Time Report for 2025-10-01 to 2025-10-31
Filters: Group by: Employee

👤 John Doe
   Capacity: 168.00 hours
   Tracked: 160.00 hours (9600 minutes)
   Billable: 140.00 hours (8400 minutes)
   Utilization: 95.24%

👤 Jane Smith
   Capacity: 168.00 hours
   Tracked: 152.00 hours (9120 minutes)
   Billable: 145.00 hours (8700 minutes)
   Utilization: 90.48%

--- Summary ---
Total Items: 2
Total Tracked: 312.00 hours (18720 minutes)
Total Billable: 285.00 hours (17100 minutes)

export_time_reports_json

Gets time reports as raw JSON data for programmatic analysis and custom reporting.

Parameters

Parameter	Type	Required	Description
`from`	string	Yes	Start date in YYYY-MM-DD format
`to`	string	Yes	End date in YYYY-MM-DD format
`prettyPrint`	boolean	No	Format JSON with indentation (default: true)

Sample Prompt

Export my time data for this week as JSON

Sample Response

Time Report Data: 2025-10-01 to 2025-10-07

Summary:
  Records: 15
  Total Hours: 42.50 (2550 minutes)
  Billable Hours: 38.00 (2280 minutes)
  Unique Users: 1
  Unique Projects: 3
  Approved Records: 10

[JSON data with fields: date, client, project, description,
taskUrl, trackedMinutes, isBillable, isApproved, userId,
firstName, lastName, employeeGroups, costRate, currency]

export_time_reports_csv

Exports time reports to a CSV file with optional filtering by clients, projects, users, employee groups, or approval statuses.

Parameters

Parameter	Type	Required	Description
`from`	string	Yes	Start date in YYYY-MM-DD format
`to`	string	Yes	End date in YYYY-MM-DD format
`clientIds`	array of UUIDs	No	Filter by clients
`projectIds`	array of UUIDs	No	Filter by projects
`userIds`	array of UUIDs	No	Filter by users
`employeeGroupIds`	array of UUIDs	No	Filter by employee groups
`approvalStatuses`	array of numbers	No	Filter by approval status
`jiraIssueUrls`	array of strings	No	Filter by Jira issue URLs/keys (max 100)

Sample Prompt

Export approved time records for October as CSV

Sample Response

Successfully exported time report to CSV

File: time-report-2025-10-01-2025-10-31.csv
Size: 15.42 KB
Rows: ~150 records
Period: 2025-10-01 to 2025-10-31
Filters: Approval Status: Approved

Columns: Date, Client, Project, Description, Task URL, Hours,
Billable, Approved, First Name, Last Name, Employee Groups,
Cost Rate, Currency

export_time_reports_xlsx

Exports time reports to an Excel (XLSX) file with formatted columns, auto-filter, and frozen header row.

Parameters

Parameter	Type	Required	Description
`from`	string	Yes	Start date in YYYY-MM-DD format
`to`	string	Yes	End date in YYYY-MM-DD format

Sample Prompt

Export October time report to Excel

Sample Response

Successfully exported time report to Excel

File: time-report-2025-10-01-2025-10-31.xlsx
Size: 28.75 KB
Rows: 150 records
Total Hours: 312.50
Period: 2025-10-01 to 2025-10-31

Features: Formatted columns, auto-filter, frozen header row,
number formatting for Hours and Cost Rate

list_users

Search and filter users in the system. Returns user details including employee groups, projects, roles, and cost data.

Parameters

Parameter	Type	Required	Description
`search`	string	No	Search text to filter by user name or email (fuzzy match)
`employeeGroupIds`	array of UUIDs	No	Filter by employee group UUIDs
`projectIds`	array of UUIDs	No	Filter by project UUIDs (users assigned to these projects)
`roleIds`	array of UUIDs	No	Filter by role UUIDs
`userStatuses`	array of strings	No	Filter by status: Active, Invited, Inactive
`includeCosts`	boolean	No	Include user cost data (default: true)

Sample Prompt

Show me all active users in the Development team

Sample Response

Users (5 total)
Filters: Statuses: Active
Status breakdown: Active: 5

1. Name: John Doe
   Email: john.doe@example.com
   Status: Active
   Current Cost: 75 EUR (from 2025-01-01)
   Employee Groups: 2 assigned
   Projects: 5 assigned

2. Name: Jane Smith
   Email: jane.smith@example.com
   Status: Active
   Current Cost: 85 EUR (from 2025-01-01)
   Employee Groups: 1 assigned
   Projects: 3 assigned

get_user

Get detailed information for a specific user including employee groups, projects, roles, and cost data. Lookup by user ID, email, or name.

Parameters

Parameter	Type	Required	Description
`userId`	string (UUID)	No	User UUID to lookup directly
`email`	string	No	User email to search by
`name`	string	No	User name to search by (first name, last name, or full name)
`asOfDate`	string	No	Date to get cost data as of (YYYY-MM-DD). Default: today

Note: At least one of userId, email, or name must be provided.

Sample Prompt

Get details for user john.doe@example.com

Sample Response

=== User Details ===
ID: a1b2c3d4-e5f6-7890-abcd-ef1234567890
Name: John Doe
Email: john.doe@example.com
Username: john.doe@example.com
Phone: +1234567890
Status: Active
Active: Yes
Email Confirmed: Yes

=== Cost Data ===
Current Cost (as of 2025-10-21): 75 EUR
  Effective from: 2025-01-01

Cost History:
  - 2025-01-01: 75 EUR
  - 2024-01-01: 70 EUR

=== Employee Groups ===
Assigned to 2 group(s)
  - Development
  - Backend Team

=== Projects ===
Assigned to 5 project(s)

=== Roles ===
Has 2 role(s)
  - admin
  - employee

create_user

Create a new user in the system. The user will be created with "Invited" status and will receive an invitation email to set their password.

Parameters

Parameter	Type	Required	Description
`email`	string	Yes	User email address (must be unique)
`firstName`	string	Yes	User first name
`lastName`	string	Yes	User last name
`defaultCapacityPerWeekHours`	number	Yes	Default weekly capacity in hours (0-168, typically 40 for full-time)
`phoneNumber`	string	No	User phone number

Sample Prompt

Create a new user John Smith with email john.smith@example.com and 40 hours weekly capacity

Sample Response

User created successfully!

ID: a1b2c3d4-e5f6-7890-abcd-ef1234567890
Name: John Smith
Email: john.smith@example.com
Status: Invited
Weekly Capacity: 40 hours

An invitation email has been sent to the user to set their password.

update_user

Update user information. Identify user by ID, email, or name (use findBy* params). Provide fields to update.

Parameters

Parameter	Type	Required	Description
`findByUserId`	string (UUID)	No	Find user by UUID to update directly
`findByEmail`	string	No	Find user by email address
`findByName`	string	No	Find user by name (fuzzy search)
`email`	string	No	New email address for the user
`firstName`	string	No	New first name for the user
`lastName`	string	No	New last name for the user
`phoneNumber`	string	No	New phone number for the user
`defaultCapacityPerWeekHours`	number	No	New default weekly capacity (0-168)

Note: At least one findBy* parameter and one update field must be provided.

Sample Prompt

Update John Doe's weekly capacity to 32 hours

Sample Response

User updated successfully!

User: John Doe (john.doe@example.com)
ID: a1b2c3d4-e5f6-7890-abcd-ef1234567890

Changes:
  - Weekly Capacity: 40 -> 32 hours

delete_user

Delete a user from the system (soft delete). The user will be removed but their data retained. Users with tracked time cannot be deleted.

Parameters

Parameter	Type	Required	Description
`userId`	string (UUID)	No	User UUID to delete directly
`email`	string	No	User email to find and delete
`name`	string	No	User name to find and delete

Note: At least one of userId, email, or name must be provided. Users with tracked time cannot be deleted - use change_user_status to deactivate them instead.

Sample Prompt

Delete user john.smith@example.com

Sample Response

User deleted successfully!

Deleted user: John Smith (john.smith@example.com)
ID: a1b2c3d4-e5f6-7890-abcd-ef1234567890

change_user_status

Activate or deactivate a user. Deactivated users cannot log in but their data is preserved. You cannot deactivate yourself.

Parameters

Parameter	Type	Required	Description
`action`	string	Yes	"activate" or "deactivate"
`userId`	string (UUID)	No	User UUID to change status directly
`email`	string	No	User email to find
`name`	string	No	User name to find

Note: At least one of userId, email, or name must be provided.

Sample Prompt

Deactivate user John Smith

Sample Response

User deactivated successfully!

User: John Smith (john.smith@example.com)
ID: a1b2c3d4-e5f6-7890-abcd-ef1234567890
Previous Status: Active
New Status: Inactive

get_user_costs

Get cost rate history for a user. Optionally get the active cost rate at a specific date.

Parameters

Parameter	Type	Required	Description
`userId`	string (UUID)	No	User UUID to get costs for
`email`	string	No	User email to find user by
`name`	string	No	User name to find user by
`asOfDate`	string	No	Date to get active cost as of (YYYY-MM-DD). Default: shows all cost history

Note: At least one of userId, email, or name must be provided.

Sample Prompt

What is John Doe's current cost rate?

Sample Response

Cost data for: John Doe (john.doe@example.com)
User ID: a1b2c3d4-e5f6-7890-abcd-ef1234567890

Current active cost:
  Rate: 75 EUR
  Effective from: 2025-01-01

Cost History:
  1. 2025-01-01: 75 EUR (current)
  2. 2024-01-01: 70 EUR
  3. 2023-01-01: 65 EUR

add_user_cost

Add a new cost rate entry for a user. Each cost entry has a valid-from date - the rate is effective from that date until the next cost entry.

Parameters

Parameter	Type	Required	Description
`costRate`	number	Yes	Cost rate (hourly rate, must be >= 0)
`currency`	string	Yes	Currency: EUR or USD
`validFrom`	string	Yes	Date from which this cost rate is effective (YYYY-MM-DD)
`userId`	string (UUID)	No	User UUID to add cost for
`email`	string	No	User email to find user by
`name`	string	No	User name to find user by

Note: At least one of userId, email, or name must be provided.

Sample Prompt

Set John Doe's cost rate to 80 EUR starting from 2026-01-01

Sample Response

Cost entry added successfully!

User: John Doe (john.doe@example.com)
New cost: 80 EUR (effective from 2026-01-01)

Cost history:
  1. 2026-01-01: 80 EUR
  2. 2025-01-01: 75 EUR
  3. 2024-01-01: 70 EUR

delete_user_cost

Delete a cost rate entry for a user by its valid-from date.

Parameters

Parameter	Type	Required	Description
`validFrom`	string	Yes	The valid-from date of the cost entry to delete (YYYY-MM-DD)
`userId`	string (UUID)	No	User UUID to delete cost for
`email`	string	No	User email to find user by
`name`	string	No	User name to find user by

Note: At least one of userId, email, or name must be provided.

Sample Prompt

Delete John Doe's cost entry from 2026-01-01

Sample Response

Cost entry deleted successfully!

User: John Doe (john.doe@example.com)
Deleted: 2026-01-01: 80 EUR

Remaining cost history:
  1. 2025-01-01: 75 EUR
  2. 2024-01-01: 70 EUR

list_employee_groups

List all employee groups in the system. Returns group IDs, names, and member counts. Use the Group ID to filter time reports by employee group.

Parameters

None required.

Sample Prompt

Show me all employee groups

Sample Response

Found 3 employee group(s):

┌────────────────────────────────────────┬──────────────────────────────────┬──────────────┐
│ Group ID                               │ Group Name                       │ Members      │
├────────────────────────────────────────┼──────────────────────────────────┼──────────────┤
│ a1b2c3d4-e5f6-7890-abcd-ef1234567890   │ Development                      │ 8            │
│ b2c3d4e5-f6a7-8901-bcde-f12345678901   │ Design                           │ 4            │
│ c3d4e5f6-a7b8-9012-cdef-123456789012   │ Management                       │ 3            │
└────────────────────────────────────────┴──────────────────────────────────┴──────────────┘

Use the Group ID to filter time reports by employee group with get_all_time_reports.

submit_for_approval

Submit time entries for approval. Submit your own time or (with permission) submit on behalf of another user. Submits all time entries in the date range for approval workflow.

Parameters

Parameter	Type	Required	Description
`from`	string	Yes	Start date in YYYY-MM-DD format
`to`	string	Yes	End date in YYYY-MM-DD format
`userId`	string (UUID)	No	User UUID to submit on behalf of (requires TrackOnBehalf permission)

Sample Prompt (Own Time)

Submit my time entries for October for approval

Sample Prompt (On Behalf)

Submit John Doe's time for this week for approval

Sample Response

Time entries submitted for approval successfully!

Period: 2025-10-01 to 2025-10-31
Submitted for: yourself

search_pending_approvals

Search for time entries pending approval. Returns a list of users with their pending time entries, tracked hours, and capacity for the specified date range.

Parameters

Parameter	Type	Required	Description
`from`	string	Yes	Start date in YYYY-MM-DD format
`to`	string	Yes	End date in YYYY-MM-DD format
`userIds`	array of UUIDs	No	Filter by user UUIDs
`employeeGroupIds`	array of UUIDs	No	Filter by employee group UUIDs
`approvalStatus`	number	No	Approval status: 0=Draft, 1=Pending (default), 2=Approved, 3=Declined

Sample Prompt

Show me all pending time entries for October

Sample Response

Time Entries: Pending
Period: 2025-10-01 to 2025-10-31

1. John Doe (a1b2c3d4-e5f6-7890-abcd-ef1234567890)
   Days pending: 22
   Tracked: 176.00h | Billable: 160.00h | Capacity: 168.00h
   Utilization: 104.8%
   Day IDs: d1e2f3..., d4e5f6..., d7e8f9... +19 more

2. Jane Smith (b2c3d4e5-f6a7-8901-bcde-f12345678901)
   Days pending: 20
   Tracked: 160.00h | Billable: 145.00h | Capacity: 168.00h
   Utilization: 95.2%
   Day IDs: e1f2g3..., e4f5g6..., e7f8g9... +17 more

--- Summary ---
Users: 2
Total Days: 42
Total Tracked: 336.00 hours
Total Billable: 305.00 hours
Total Capacity: 336.00 hours
Overall Utilization: 100.0%

To approve these entries, use the approve_time_entries tool.

approve_time_entries

Approve pending time entries for a date range. Automatically fetches all pending entries and approves them. Can filter by users or employee groups.

Parameters

Parameter	Type	Required	Description
`from`	string	Yes	Start date in YYYY-MM-DD format
`to`	string	Yes	End date in YYYY-MM-DD format
`userIds`	array of UUIDs	No	Filter by user UUIDs
`employeeGroupIds`	array of UUIDs	No	Filter by employee group UUIDs

Sample Prompt

Approve all pending time entries for October

Sample Response

Time entries approved successfully!

Period: 2025-10-01 to 2025-10-31
Total approved: 42 user day(s)

Users approved:
  - John Doe: 22 day(s)
  - Jane Smith: 20 day(s)

decline_time_entries

Decline (reject) approved time entries for a date range. Automatically fetches all approved entries and declines them. Can filter by users or employee groups.

Parameters

Parameter	Type	Required	Description
`from`	string	Yes	Start date in YYYY-MM-DD format
`to`	string	Yes	End date in YYYY-MM-DD format
`userIds`	array of UUIDs	No	Filter by user UUIDs
`employeeGroupIds`	array of UUIDs	No	Filter by employee group UUIDs

Sample Prompt

Decline John Doe's approved time entries for October

Sample Response

Time entries declined successfully!

Period: 2025-10-01 to 2025-10-31
Total declined: 22 user day(s)

Users declined:
  - John Doe: 22 day(s)

📚 Need help getting started?

Visit the Fritto documentation for detailed guides on using the MCP server with your AI assistant.

🕐 Fritto MCP Server

Server Status: ⚡ Ready

🔌 How to Connect

Method 1: OAuth 2.0 (Recommended)

Method 2: API Token (Personal Access Token)

️ Available Tools

Quick Navigation

Time Tracking

Reports

User Management

User Costs

Employee Groups

Approval Workflow

log_time

Parameters

Sample Prompt (Own Time)

Sample Prompt (On Behalf)

Sample Response

list_projects

Parameters

Sample Prompt (Own Projects)

Sample Prompt (On Behalf)

Sample Response

get_time_records

Parameters

Sample Prompt (Own Time)

Sample Prompt (On Behalf)

Sample Response

get_tracked_time

Parameters

Sample Prompt

Sample Response

validate_day

Parameters

Sample Prompt (Own)

Sample Prompt (On Behalf)

Sample Response (Editable)

Sample Response (Locked)

update_time_record

Parameters

Sample Prompt (Own Time)

Sample Prompt (On Behalf)

Sample Response

delete_time_record

Parameters

Sample Prompt (Own Time)

Sample Prompt (On Behalf)

Sample Response

get_own_time_reports

Parameters

Sample Prompt

Sample Response

get_all_time_reports

Parameters

Sample Prompt

Sample Response

export_time_reports_json

Parameters

Sample Prompt

Sample Response

export_time_reports_csv

Parameters

Sample Prompt

Sample Response

export_time_reports_xlsx

Parameters

Sample Prompt

Sample Response

list_users

Parameters

Sample Prompt

Sample Response

get_user

Parameters

Sample Prompt

Sample Response

create_user

Parameters

Sample Prompt

Sample Response