# Worksnaps — MCP server on mcp.ai
> Connect your Worksnaps account and use 14 tools for time tracking straight from your AI agent. Connect with your own API key. Worksnaps is a time-tracking service designed for remote work that offers detailed project and user activity insights.

By: mcp.ai · official
Page: https://mcp.ai/worksnaps

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_worksnaps?ms=1787293620000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/worksnaps/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/worksnaps/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/worksnaps/skill.md
Postman collection (v2.1): https://mcp.ai/worksnaps/postman.json

## Tools
- worksnaps_create_project(name: string, description?: string) — Creates a new project in Worksnaps for tracking time and tasks. Use this tool when you need to set up a new project for time tracking. Projects serve as containers for tasks and time entries. Each pro
- worksnaps_create_task(name: string, user_id?: integer, due_date?: string, project_id: integer, description?: string) — Tool to create a new task in a specified project. Use after confirming project ID exists.
- worksnaps_delete_task(task_id: integer, project_id: integer) — Permanently deletes a task from a Worksnaps project. This action is destructive and cannot be undone. Use GET_TASKS first to find the task_id, and GET_PROJECTS to find the project_id. Returns success=
- worksnaps_get_project_details(project_id: integer) — Tool to retrieve details of a specific project. Use when you have a project_id and need its details.
- worksnaps_get_project_report(task_ids?: string, user_ids?: string, project_id: integer, to_timestamp: integer, from_timestamp: integer, time_entry_type?: string) — Retrieves time entries for a specific project using the Worksnaps Time Entries API. Returns individual time tracking records showing when users worked on the project. Use this to get detailed time tra
- worksnaps_get_projects(page?: integer, per_page?: integer) — Tool to retrieve a paginated list of projects. Use after authenticating to list accessible projects.
- worksnaps_get_task_details(task_id: integer, project_id: integer) — Tool to retrieve details of a specific task within a project. Use after confirming project_id and task_id.
- worksnaps_get_tasks(page?: integer, status?: string, user_id?: integer, per_page?: integer, project_id: integer) — Tool to retrieve tasks for a specific project. Use when you have a project ID and need its tasks. Example: 'Get tasks for project 42'.
- worksnaps_get_user_account(user_id: integer) — Tool to retrieve information about a specific user account. Use after confirming the user_id.
- worksnaps_get_user_assignments(project_id: integer) — Tool to retrieve a list of all user assignments for a specific project. Returns details about users assigned to the project including their roles, permissions, and contact information.
- worksnaps_get_users() — Retrieves a list of all users in the Worksnaps account. Returns user details including id, login, name, email, time zone, and active status. Use this to get user IDs for other user-related operations.
- worksnaps_put_update_project(name?: string, status?: string, end_date?: string, client_id?: integer, project_id: integer, start_date?: string, description?: string) — Tool to update an existing project. Use when you have project_id and fields to modify.
- worksnaps_put_update_task(name?: string, status?: string, task_id: integer, due_date?: string, project_id: integer, description?: string) — Tool to update details of an existing task. Use when you have project_id, task_id, and fields to update.
- worksnaps_put_update_user_account(email?: string, user_id: integer, password?: string, last_name?: string, first_name?: string, timezone_id?: integer, password_confirmation?: string) — Tool to update information for a specific user account. Use when modifying user details after confirming the user exists. Note: This can only be done by the user himself or by a trusted partner using 

## Example prompts
- "What can I do in Worksnaps?"
- "Show me a summary of my Worksnaps account"

## Links
Docs: https://mcp.ai/docs/mcps/worksnaps
Website: https://mcp.ai/mcps/worksnaps