Skip to content
MCP server

Smartplan MCP by usefulapi

Read-only access to Smartplan shifts, worklogs, absences and staff for AI assistants

Install
Pricing
Freemium
Platforms
API, Web
Runs
Remotely
Version
1.11.1
Listing updated
today

About Smartplan MCP by usefulapi

Smartplan MCP by usefulapi is a freemium MCP server for hr and payroll. It runs as a hosted remote server, so there is nothing to install locally.

The server connects a Smartplan account to Claude, ChatGPT, Cursor and other MCP clients over a hosted Streamable HTTP endpoint. Once connected, an assistant can list and look up shifts, recorded worklogs, absence dates, members, locations and job roles from the account you log in with.

Access works through the Smartplan API using your own API client ID and secret, entered once on a login page with OAuth. Account settings and timezone are included so dates are read correctly. Absence reasons, health categories, notes, contact details and payroll data are excluded, and all 14 data tools are read-only.

The README and product page describe it mainly for staffing managers who want to review rotas, compare planned and attended hours, and check absences before scheduling. It is an independent service by usefulapi, not an official Smartplan product.

Install

Run in a terminal

claude mcp add --transport http smartplan https://smartplan.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://smartplan.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "smartplan": {
      "url": "https://smartplan.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "smartplan": {
      "type": "http",
      "url": "https://smartplan.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "smartplan": {
      "serverUrl": "https://smartplan.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "smartplan": {
      "type": "http",
      "url": "https://smartplan.usefulapi.io/mcp"
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (14)

Taken from the project documentation; the running server may differ.

smartplan_list_accounts
Shows only the account selected during login.
smartplan_get_account
Account settings and timezone for the selected account.
smartplan_list_members
One page of members for the selected account.
smartplan_get_member
One member by ID in the selected account.
smartplan_list_locations
One page of locations for the selected account.
smartplan_get_location
One location by ID in the selected account.
smartplan_list_jobtypes
One page of job roles for the selected account.
smartplan_get_jobtype
One job role by ID in the selected account.
smartplan_list_shifts
One page of upcoming shifts for the selected account.
smartplan_get_shift
One shift by ID in the selected account.
smartplan_list_worklogs
One page of recorded worklogs for the selected account.
smartplan_get_worklog
One worklog by ID in the selected account.
smartplan_list_absences
One page of absence dates for the selected account.
smartplan_get_absence
One absence by ID in the selected account.

What it does

Read-only shift access
Lists and fetches upcoming shifts, with date filters based on the displayed start date.
Worklog comparison
Retrieves recorded worklogs so planned and attended hours can be compared for a period.
Absence date lookup
Shows approved absence dates without reasons, categories or notes.
Locations and job roles
Reads locations and job roles so shifts can be filtered by site and role.
Account and timezone check
Confirms which Smartplan account is connected and its timezone settings.
OAuth sign-in
Connects with Smartplan API credentials on a login page, with no API key in the client config.

Good for

  • Reviewing next week's shifts by location and job role
  • Comparing planned and attended hours from last week's worklogs
  • Checking approved absence dates before building a rota
  • Confirming which Smartplan account and timezone a connection uses

Pricing

Freemium, from $9 a month

Free plan with 50 tool calls/month; Pro from $9/mo or $90/yr; Pro+ $39/mo or $390/yr

Prices change. Check usefulapi.io before you buy.

Smartplan MCP by usefulapi FAQ

Is this an official Smartplan product?

No. usefulapi is an independent service and is not affiliated with or endorsed by Smartplan.

What do I need to connect?

The login page asks for your Smartplan API client ID and client secret. The account owner enables API access in Smartplan Settings under API.

Can the AI change my Smartplan data?

All 14 Smartplan data tools are marked read-only.

What does it cost?

The Free plan includes 50 tool calls a month. Pro is $9/mo or $90/yr with 10,000 calls a month, and Pro+ is $39/mo or $390/yr with 100,000 calls a month. Each subscription covers this server only.

Is Smartplan MCP by usefulapi free?

Smartplan MCP by usefulapi has a free plan, with paid plans for more usage or features. Paid plans start at $9 a month.

How do I add Smartplan MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http smartplan https://smartplan.usefulapi.io/mcp

What are the best alternatives to Smartplan MCP by usefulapi?

The closest alternatives to Smartplan MCP by usefulapi are When I Work MCP by usefulapi, Jisr MCP by usefulapi, intelliHR MCP by usefulapi, Employment Hero Payroll MCP by usefulapi and PaySpace MCP by usefulapi.

Where this comes from

  • Description: written from the project's README, the project's website and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers

Alternatives to Smartplan MCP by usefulapi

  1. Hosted MCP server connecting When I Work scheduling, timesheets and time off to AI clients

    Not checked yet
    • 21 tools
    • Remote
    • Freemium
    • Hr and payroll
  2. Hosted MCP server connecting AI assistants to Jisr HR, attendance and payroll data

    Not checked yet
    • 16 tools
    • Remote
    • Freemium
    • Hr and payroll
  3. Hosted MCP server letting AI assistants read and update intelliHR people, jobs and leave

    Not checked yet
    • 22 tools
    • Remote
    • Freemium
    • Hr and payroll
  4. Read-only MCP server giving AI assistants access to PaySpace HR and payroll records

    Not checked yet
    • 21 tools
    • Remote
    • Freemium
    • Hr and payroll
  5. Hosted MCP connector letting AI assistants read TempClock workers, sites, shifts

    Not checked yet
    • 5 tools
    • Remote
    • Freemium
    • Hr and payroll