Smartplan MCP by usefulapi
Read-only access to Smartplan shifts, worklogs, absences and staff for AI assistants
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://smartplan.usefulapi.io/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"smartplan": {
"url": "https://smartplan.usefulapi.io/mcp"
}
}
}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.
Alternatives to Smartplan MCP by usefulapi
When I Work MCP by usefulapi
MCP serverHosted MCP server connecting When I Work scheduling, timesheets and time off to AI clients
Not checked yet- 21 tools
- Remote
- Freemium
- Hr and payroll
Jisr MCP by usefulapi
MCP serverHosted MCP server connecting AI assistants to Jisr HR, attendance and payroll data
Not checked yet- 16 tools
- Remote
- Freemium
- Hr and payroll
intelliHR MCP by usefulapi
MCP serverHosted MCP server letting AI assistants read and update intelliHR people, jobs and leave
Not checked yet- 22 tools
- Remote
- Freemium
- Hr and payroll
Employment Hero Payroll MCP by usefulapi
MCP serverHosted MCP server giving AI assistants read access to Employment Hero Payroll data
Not checked yet- 26 tools
- Remote
- Freemium
- Hr and payroll
PaySpace MCP by usefulapi
MCP serverRead-only MCP server giving AI assistants access to PaySpace HR and payroll records
Not checked yet- 21 tools
- Remote
- Freemium
- Hr and payroll
TempClock MCP by usefulapi
MCP serverHosted MCP connector letting AI assistants read TempClock workers, sites, shifts
Not checked yet- 5 tools
- Remote
- Freemium
- Hr and payroll