# Smartplan MCP by usefulapi

> Smartplan MCP by usefulapi is a freemium MCP server for hr and payroll. Read-only access to Smartplan shifts, worklogs, absences and staff for AI assistants. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $9 a month
- **Platforms:** API, Web
- **Website:** https://usefulapi.io/smartplan/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/smartplan
- **MCP Registry name:** io.usefulapi/smartplan
- **Categories:** hr and payroll
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://smartplan.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "smartplan": {
      "url": "https://smartplan.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

- [When I Work MCP by usefulapi](https://ai-powered.com/mcp/when-i-work-mcp-by-usefulapi): When I Work MCP by usefulapi is a freemium MCP server for hr and payroll.
- [Jisr MCP by usefulapi](https://ai-powered.com/mcp/jisr-mcp-by-usefulapi): Jisr MCP by usefulapi is a freemium MCP server for hr and payroll.
- [intelliHR MCP by usefulapi](https://ai-powered.com/mcp/intellihr-mcp-by-usefulapi): intelliHR MCP by usefulapi is a freemium MCP server for hr and payroll.
- [Employment Hero Payroll MCP by usefulapi](https://ai-powered.com/mcp/employment-hero-payroll-mcp-by-usefulapi): Employment Hero Payroll MCP by usefulapi is a freemium MCP server for hr and payroll.
- [PaySpace MCP by usefulapi](https://ai-powered.com/mcp/payspace-mcp-by-usefulapi): PaySpace MCP by usefulapi is a freemium MCP server for hr and payroll.
- [TempClock MCP by usefulapi](https://ai-powered.com/mcp/tempclock-mcp-by-usefulapi): TempClock MCP by usefulapi is a freemium MCP server for hr and payroll.
- [Breathe HR MCP by usefulapi](https://ai-powered.com/mcp/breathe-hr-mcp-by-usefulapi): Breathe HR MCP by usefulapi is a freemium MCP server for hr and payroll.
- [Go2Clock MCP by usefulapi](https://ai-powered.com/mcp/go2clock-mcp-by-usefulapi): Go2Clock MCP by usefulapi is a freemium MCP server for hr and payroll.

---
Source: https://ai-powered.com/mcp/smartplan-mcp-by-usefulapi
