What you can do with Insightful

Built for

People Operations, Workforce Analytics Teams, Project Managers, IT Administrators

Example workflows

Review org structure

Grounds workforce questions in live org structure instead of guesses.

Try this

List Insightful teams and employees, summarize each team id and name, and note which teams have members assigned.

Audit active projects

Turns project inventory into a planning brief before allocation changes.

Try this

What projects exist in Insightful right now? Give id and name for each, and flag any with no assigned employees or teams.

Create a sandbox project

Shows safe project creation with explicit empty membership arrays.

Try this

Create an Insightful project named 'Q2 onboarding rollout' with no employees or teams assigned yet, then report the new project id.

Inspect tracking settings

Connects productivity policy review to reusable settings rows.

Try this

Summarize Insightful shared settings profiles — name, id, and whether screenshots or idle detection are enabled on each.

Context to know first

What can AI agents do with Insightful?

Agents can list or fetch employees, teams, directories, app categories, app tags, projects, tasks, scheduled shift rules, and shared tracking settings. They can also create or update projects, tasks, and shared settings, and delete those rows when asked.

How does Insightful authentication work on MCPBundles?

Connect with your Insightful organization admin credentials on MCPBundles. The platform keeps the connection secure after setup.

What order should agents follow for Insightful writes?

Resolve organization context, create or pick a project, then create tasks under that project id. Shared settings updates should copy an existing profile shape before authoring a new one.

Related editorial

Insightful Workforce Workflows with AI

How AI agents can review teams and employees, manage projects and tasks, and inspect shared tracking settings.

Read article

AI Skill
SKILL.md

Domain knowledge for Insightful — workflow patterns, data models, and gotchas for your AI agent.

Insightful

Insightful is org structure first, then projects and tasks, then tracking settings — create a project before tasks, resolve organization context from tags or teams before writes, and treat shared settings as reusable tracking profiles.

The MCP surface targets Insightful v1 REST at app.insightful.io/api/v1 (kebab-case paths, Bearer token, next pagination).

Hierarchy

  • Organization — implied by the API token; organizationId appears on tags, settings, and writable rows.
  • Team — groups employees and projects; carries productivity ignore flags.
  • Employee — directory members with email and timestamps.
  • Project — time-allocation container with statuses, priorities, payroll, member lists.
  • Task — work item under exactly one projectId; requires status, priority, and employees array on create (empty array allowed).
  • Shared settings — reusable tracking profiles (idle, screenshots, breaks).
  • Scheduled shift settings — org clock rules (list-only API).
  • App category / app tag — read-only application taxonomy and colored labels.
  • Directory — HR/directory connector metadata.

Operational order

  1. Resolve org context from teams or app tags when a write needs organizationId.
  2. Create or select a project before creating tasks (projectId is mandatory).
  3. Use shared settings profiles when adjusting tracking behavior — copy an existing settings object shape before authoring a new profile.
  4. Prefer get_* with id for single rows; omit id to list and follow next cursors.
  5. Do not send a limit query param — Insightful rejects it on several collections.

Write semantics

  • Project create — POST JSON with name, organizationId, employees[], teams[] (arrays may be empty).
  • Task create — POST JSON with name, projectId, organizationId, status, priority, employees[].
  • Updates — PUT /{collection}/{id} with partial JSON bodies.
  • Deletes — DELETE /{collection}/{id}; destructive and idempotent.

Telemetry collections (fragments, shifts, screenshots) and v2 export paths are not on this v1 base URL — do not assume they exist here.

Tools in this Server (15)

Insightful Delete Project

Permanently delete an Insightful project by id. Deletes associated tasks according to Insightful server rules.

Insightful Delete Shared Settings

Permanently delete a shared settings profile by id.

Insightful Delete Task

Permanently delete an Insightful task by id.

Insightful Get App Categories

List or fetch Insightful application category labels used for productivity classification. Read-only taxonomy — omit id to list all categories.

Insightful Get App Tags

List or fetch Insightful app tags (name + color labels scoped to the organization). Omit id to list tags; pass id for one tag including organizationId...

Insightful Get Directories

List or fetch directory integrations (CSV/HR sync sources). Omit id to list directory connectors with sync status; pass id for one directory row.

Insightful Get Employees

List or fetch Insightful employees. Omit id to walk the employee collection with optional ``next`` pagination and ``start``/``end`` filters on ``updat...

Insightful Get Projects

List or fetch Insightful projects used for time allocation and ticketing. Omit id to list projects with optional ``next`` pagination; pass id for one ...

Insightful Get Scheduled Shift Settings

List scheduled shift clock rules for the organization (earliest clock-in, late threshold, latest clock-out, tolerance). This collection is list-only —...

Insightful Get Shared Settings

List or fetch shared tracking settings profiles (office/personal/tracking types with idle, screenshot, and break rules). Omit id to list; pass id for ...

Insightful Get Tasks

List or fetch tasks within Insightful projects. Omit id to list tasks with optional ``next`` pagination; pass id for one task including status, priori...

Insightful Get Teams

List or fetch Insightful teams. Teams group employees and projects and carry productivity-exclusion settings for apps. Omit id to list; pass id for on...

Insightful Upsert Project

Create or update an Insightful project. Omit id to POST a new project — requires name; organizationId defaults from the connected org when omitted; em...

Insightful Upsert Shared Settings

Create or update a shared settings profile. Omit id to POST — requires name, type, and settings object; organizationId is inferred when omitted. Pass ...

Insightful Upsert Task

Create or update an Insightful task. Omit id to POST — requires name, projectId, status, priority, and employees (use an empty array when unassigned)....

Frequently Asked Questions

What is the Insightful MCP server?

Insightful is a workforce productivity and time-tracking platform for monitoring employee activity, managing projects and tasks, and reporting on time usage. It provides 15 tools that AI agents can use through the Model Context Protocol (MCP).

How do I connect Insightful to my AI agent?

Add the MCPBundles server URL to your MCP client configuration (Claude Desktop, Cursor, VS Code, etc.). The URL format is: https://mcp.mcpbundles.com/bundle/insightful. Authentication is handled automatically.

How many tools does Insightful provide?

Insightful provides 15 tools that can be called by AI agents, along with a SKILL.md that gives your AI agent domain knowledge about when and how to use them.

What authentication does Insightful require?

Insightful uses API Key. Insightful requires credentials. Connect via MCPBundles and authentication is handled automatically.

What can AI agents do with Insightful?

Agents can list or fetch employees, teams, directories, app categories, app tags, projects, tasks, scheduled shift rules, and shared tracking settings. They can also create or update projects, tasks, and shared settings, and delete those rows when asked.

How does Insightful authentication work on MCPBundles?

Connect with your Insightful organization admin credentials on MCPBundles. The platform keeps the connection secure after setup.

What order should agents follow for Insightful writes?

Resolve organization context, create or pick a project, then create tasks under that project id. Shared settings updates should copy an existing profile shape before authoring a new one.

How do I get an Insightful account to use with MCPBundles?

Create an organization on Insightful first, then connect here with an API token from Settings → API Tokens. MCPBundles works with Insightful accounts you already own.

Which Insightful data is read-only in this integration?

App categories, app tags, scheduled shift settings, and directory connectors are read-only in this integration. Telemetry exports and screenshot feeds are not included here.

Setup Instructions

Connect Insightful to any MCP client in minutes

MCP URL
https://mcp.mcpbundles.com/bundle/insightful

One-click install:

The link prefills the Add custom connector dialog — you still review the values and click Add, then Connect to complete OAuth.

Or add manually

  1. Open claude.ai → Settings → Connectors.
  2. Click the + button and choose Add custom connector.
  3. Set Name to Insightful and paste the MCP URL into Remote MCP server URL.
  4. Click Add. Insightful will appear under Not connected — select it and click Connect to complete OAuth.
Name: Insightful
Remote MCP server URL: https://mcp.mcpbundles.com/bundle/insightful
Authentication: OAuth

Custom connectors at claude.ai require a paid Claude plan (Pro, Max, Team, or Enterprise).

Ready to use Insightful?

Sign in to connect your credentials and start running tools from the chat.

Insightful MCP Server & Skill — 15 Tools