# Teamso

> Teamso is an MCP server for hr and payroll. Run HR tasks in Teamso from your AI assistant: leave, approvals, goals and payslips. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Platforms:** Web, API, CLI
- **Website:** https://teamso.com/docs/teamso-mcp-server
- **MCP Registry name:** com.teamso/mcp
- **Categories:** [hr and payroll](https://ai-powered.com/categories/hr-and-payroll)
- **Listing updated:** 2026-11-18

## About

Teamso is a Turkish HR and payroll platform, and its hosted MCP server lets an assistant act inside your account with your own permissions. The docs list requesting leave, approving requests, managing goals, opening your payslip, searching guides and working with any other module your role unlocks. The server stores no credentials.

Sign-in clients such as ChatGPT, Claude, Claude Code, Cursor, VS Code and Grok connect with just the server address and an approval screen in Teamso. On that screen you can switch off change permission so the app only reads, and choose how long it stays connected, from 7 days to indefinitely with 90 as the default. Connected apps can be reviewed and cut off in Teamso. Clients without browser sign-in, such as Windsurf, use a personal access token.

Claude Desktop can instead use a pinned npm package, @teamso/teamso-mcp, which talks to the Teamso API directly and needs Node.js 20 or later. The documentation is written in Turkish.

## Features

- **Acts with your permissions:** Every request runs with your own access rights.
- **Browser sign-in:** Add the server address and approve in Teamso, no token to copy.
- **Read-only option:** Turn off change permission so the app can only read.
- **Choice of connection length:** Stay connected from 7 days to indefinitely.
- **Personal access tokens:** Token setup for clients without browser sign-in.
- **Local npm package:** A pinned package for Claude Desktop.

## Good for

- Request time off by asking your assistant
- Approve pending team requests in chat
- Open your latest payslip
- Update goals without opening the app
- Look up HR process guides

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp https://mcp.teamso.com/v1
```

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

```sh
https://mcp.teamso.com/v1
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "url": "https://mcp.teamso.com/v1"
    }
  }
}
```

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

```json
{
  "servers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.teamso.com/v1"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "serverUrl": "https://mcp.teamso.com/v1"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.teamso.com/v1"
    }
  }
}
```

## FAQ

### How does it authenticate?

Either browser sign-in (OAuth) or a personal access token created in Teamso.

### Can the assistant change data?

Only if you leave the change permission on; switching it off makes the app read-only.

### Does it store my credentials?

The docs say the server stores no credentials.

### Which clients are supported?

ChatGPT, Claude, Claude Code, Cursor, VS Code and Grok with sign-in; Windsurf and others with a token.

### How do I add Teamso to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp https://mcp.teamso.com/v1

### What are the best alternatives to Teamso?

The closest alternatives to Teamso are Rotawise Shift Scheduler, TopTimesheets Deskless Clock-In & Payroll ROI, clockin MCP by usefulapi, Timebutler MCP by usefulapi and Paychex Europe Payroll MCP by usefulapi.

## Where this comes from

- Description: written from the project's website.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Rotawise Shift Scheduler](https://ai-powered.com/mcp/rotawise-shift-scheduler): Rotawise Shift Scheduler is an MCP server for hr and payroll.
- [TopTimesheets Deskless Clock-In & Payroll ROI](https://ai-powered.com/mcp/toptimesheets-deskless-clock-in-and-payroll-roi): TopTimesheets Deskless Clock-In & Payroll ROI is a freemium MCP server for communication.
- [clockin MCP by usefulapi](https://ai-powered.com/mcp/clockin-mcp-by-usefulapi): clockin MCP by usefulapi is a freemium MCP server for hr and payroll.
- [Timebutler MCP by usefulapi](https://ai-powered.com/mcp/timebutler-mcp-by-usefulapi): Timebutler MCP by usefulapi is a freemium MCP server for hr and payroll.
- [Paychex Europe Payroll MCP by usefulapi](https://ai-powered.com/mcp/paychex-europe-payroll-mcp-by-usefulapi): Paychex Europe Payroll MCP by usefulapi is a freemium MCP server for hr and payroll.
- [CareLineLive MCP by usefulapi](https://ai-powered.com/mcp/carelinelive-mcp-by-usefulapi): CareLineLive 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.
- [HolidayPitches MCP by usefulapi](https://ai-powered.com/mcp/holidaypitches-mcp-by-usefulapi): HolidayPitches MCP by usefulapi is a freemium MCP server for travel booking.

---
Source: https://ai-powered.com/mcp/teamso
