Worksnaps MCP server

Connect Worksnaps to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the Worksnaps MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the update project tool in Worksnaps
  • Use the get user tool in Worksnaps
  • Use the get summary report tool in Worksnaps
  • Use the manage task assignments tool in Worksnaps
  • Use the get time entries tool in Worksnaps
  • Use the delete task tool in Worksnaps

Supported Tools

update_project

Update Project

Update an existing project's name or description. Only the fields provided will be updated; omitted fields remain unchanged.

get_user

Get User

Retrieve details for a specific user account or the currently authenticated user. Returns profile information including name, email, login, and timezone.

get_summary_report

Get Summary Report

Generate a manager summary report across projects. Provides aggregated time tracking data for the specified date range, optionally filtered by projects and users. Useful for high-level oversight and cross-project analysis.

manage_task_assignments

Manage Task Assignments

List, create, or remove task assignments within a project. Task assignments control which users are responsible for which tasks inside a project.

get_time_entries

Get Time Entries

Retrieve time entries for a project, filtered by users and date range. Each time entry represents a 10-minute "work snap" with optional screenshot, activity metrics, and task association. Can also filter by specific tasks or entry type (online/offline).

delete_task

Delete Task

Permanently delete a task from a project. This removes the task and any associated task assignments.

create_project

Create Project

Create a new project in Worksnaps. Projects are the top-level organizational unit for tracking work. After creation, users can be assigned to the project.

update_task

Update Task

Update an existing task's name or description. Only the fields provided will be updated; omitted fields remain unchanged.

create_task

Create Task

Create a new task within a project. Tasks allow teams to organize and track work at a more granular level within projects.

list_tasks

List Tasks

Retrieve all tasks within a specific project. Optionally includes task assignment details showing which users are assigned to each task.

delete_project

Delete Project

Archive a project in Worksnaps, making it inactive. Call list_projects to discover the project ID.

list_users

List Users

Retrieve users in projects managed by the authenticated user. Returns user profile information including name, email, login, and timezone.

manage_user_assignments

Manage User Assignments

List, create, update, or remove user assignments within a project. User assignments control which users can access a project and define their role (Manager, Member, or Observer) and settings like hourly rate and time logging permissions.

update_user

Update User

Update your own user profile, or another user's profile when authenticated with a trusted partner API token. Only the fields provided will be updated; omitted fields remain unchanged.

list_projects

List Projects

Retrieve all projects accessible to the authenticated user. Optionally includes user assignment details for each project, showing which users are assigned and their roles.

get_time_entry

Get Time Entry

Retrieve a specific time entry by ID, including its screenshot thumbnail URL, activity metrics, and task association. Optionally retrieve the full-resolution screenshot URL.

get_project_report

Get Project Report

Generate a time tracking report for a specific project. Supports two report types: **time_entries** (detailed per-entry data) and **time_summary** (aggregated time totals). Useful for billing, payroll, and productivity analysis.

get_project

Get Project

Retrieve details for a specific project by its ID. Optionally includes user assignment information showing who is assigned to the project and their roles.

create_offline_time_entry

Create Offline Time Entry

Log offline time in a project for yourself or another user. Call list_projects to choose a project and list_users to discover user IDs.

manage_time_entries

Manage Time Entries

Update the task or comment on logged time entries, or remove time entries from a project. Call get_time_entries to discover entry IDs.

get_task

Get Task

Retrieve a task within a project, optionally including its assigned users. Call list_projects and list_tasks to discover the project and task IDs.

Connect Worksnaps to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Worksnaps in Metorial. In your Metorial portal, enable the Worksnaps MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Worksnaps tools.

Run Worksnaps through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Worksnaps and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Worksnaps tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Worksnaps

Notion

Create, read, update, and archive pages and databases in a Notion workspace. Manage blocks (paragraphs, lists, headings, embeds, etc.) within pages. Query databases with filters and sorts across rich property types including text, numbers, dates, selects, relations, and formulas. Search across pages and databases by title. Add and read comments on pages and blocks. Upload files to pages. Manage workspace users and retrieve user profiles.

GitHub

Manage repositories, issues, and pull requests. Create and configure branches, star repositories, review code, and merge changes. Automate CI/CD workflows with GitHub Actions, manage workflow runs, secrets, and artifacts. Track issues with labels, milestones, and assignees. Search across code, repositories, issues, and users. Manage organizations, teams, and memberships. Create and manage projects, gists, packages, deployments, and environments. Access security alerts including code scanning, secret scanning, and Dependabot alerts. Read and write file contents in repositories. Manage webhooks, notifications, and codespaces.

Salesforce

Manage CRM data including Accounts, Contacts, Leads, Opportunities, Cases, and custom objects. Create, read, update, and delete records. Query data using SOQL and search across objects using SOSL. Perform bulk data operations for large-scale imports, exports, and migrations. Execute composite requests to batch multiple operations in a single API call. Access analytics, reports, and dashboards. Manage files and attachments associated with records. Interact with Chatter feeds, posts, and groups for social collaboration. Manage org metadata including custom objects, fields, layouts, and workflows. Query data using GraphQL for precise data retrieval across related objects.

Sharepoint

Manage SharePoint sites, document libraries, lists, and files. Create, read, update, and delete lists and list items with custom columns. Resolve site users to numeric Person/Group LookupId values. Upload, download, move, copy, and version files in document libraries. Search across sites, files, folders, lists, and list items using Microsoft Search. Manage permissions at site, list, and item levels with granular access control. Define and manage content types and site columns. Retrieve site properties and search for sites across Microsoft 365.

Microsoft Outlook

Send, read, reply to, forward, and manage email messages in user mailboxes. Organize messages into folders, apply categories, flags, and importance levels. Manage file and item attachments. Create, update, delete, and respond to calendar events and meetings. Find available meeting times, manage attendees, handle recurrence, and work with shared or delegated calendars. Create, read, update, and delete contacts, organize them into contact folders, and manage contact photos. Manage tasks and task lists via Microsoft To Do, including due dates, reminders, recurrence, and checklist items. Subscribe to webhook notifications for changes to messages, calendar events, and contacts. Support for Focused Inbox, @-mentions, mail tips, send-on-behalf, and send-as capabilities.

Linear

Create, read, update, and delete issues across teams with support for priorities, labels, assignees, due dates, and workflow states. Manage projects that group related issues, and organize work into time-boxed cycles (sprints). Create and manage documents, comments, and file attachments. Search issues using vector similarity or rich filters. Configure teams, workflow states, and labels. Track customers and link them to issues.

Technical notes for Worksnaps

Track time and monitor remote team activity through automated screenshots, keyboard/mouse activity, and application usage captured at 10-minute intervals. Create, update, and manage projects and tasks. Assign users to projects and tasks with role-based access. Retrieve time entries filtered by user and date range, including full-resolution screenshot URLs. Generate project-level time tracking reports for billing, payroll, and productivity analysis. Manage user accounts and user assignments across projects.

Frequently asked questions

Common questions about connecting Worksnaps to AI agents with Metorial.

  1. How many tools does the Worksnaps MCP server have?
    The Worksnaps MCP server exposes 21 tools, including Update Project, Get User, Get Summary Report. Each one is governed and traced through Metorial.
  2. Worksnaps exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Worksnaps MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Worksnaps and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Worksnaps MCP server yourself or use the hosted gateway.

Connect Worksnaps to production AI agents

See how Metorial gives your team governed access to Worksnaps, with tracing and security controls built in.