Available AI (MCP) tools - ManicTime Documentation

ManicTime Cloud and ManicTime Server currently expose these MCP tools.

Time and date

Tool	What it does
`get_current_date_time`	Returns the current UTC and local time, timezone, and day start shift.

Environments, users, and teams

Tool	What it does
`get_environments`	Lists environments, such as devices, visible to the current user.
`get_users`	Lists users visible to the signed-in user.
`get_teams`	Lists teams visible to the signed-in user.

Timelines and activities

Tool	What it does
`get_timelines`	Lists available timelines, such as computer usage, applications, documents, websites, and tags.
`get_timeline_and_summary_types`	Returns the supported timeline and summary type definitions.
`get_combined_activities`	Fetches activity data across multiple timelines for a selected time range.
`get_combined_activity_summary`	Returns grouped summaries of combined activity data.
`get_total_duration`	Returns total tracked duration for a selected time range.

Besides basic activity data, get_combined_activities can return optional fields where the client tracks them: virtual desktop name, git repository and branch, workplace, and remote client address. The AI has to request these fields explicitly, so mention them in the prompt when you want them used — for example "including the virtualDesktop field".

Groups

Tool	What it does
`get_groups`	Lists activity groups.
`get_group_summary`	Returns activity summaries grouped by group.

Tags and auto-tags

Tool	What it does
`get_available_tags`	Lists tags available to the current user. Can also include tags from external sources, such as issues synced by project management plugins (Jira, Asana, Azure DevOps...).
`get_tag_color`	Returns the color for a specific tag.
`save_tag_activities`	Saves or assigns tags to activities. Supports three modes: fill only untagged time (`FillBlanks`), tag on top of existing tags (`DoubleTag`), or replace them (`Overwrite`).
`get_auto_tags_docs`	Returns documentation for the auto-tagging system.
`export_auto_tag_settings`	Exports auto-tag configuration.
`import_auto_tag_settings`	Imports auto-tag configuration.

Tags from external sources are not returned by default — the AI has to ask for them, so say "including tags from external sources" in the prompt when you want your plugin issues considered. When a team uses an approved tag list, an approved combination normally also allows more specific tags appended after it; combinations ending with ", ." are exact and allow nothing extra. FillBlanks is the safe mode for AI tagging: it fills gaps around tags you already made without touching them.

Screenshots

Tool	What it does
`get_screenshots`	Lists screenshots taken by ManicTime for a selected time range.
`get_screenshot_image`	Retrieves a specific screenshot image.

There are 19 tools in total. Tools only return data the signed-in user is allowed to see. For example, team and user results depend on the account type, role, and permissions granted during the connection.