team
Manage team operations including members, wages, labor schedules, and cash drawer shifts within Square's platform.
Instructions
Manage team operations
Args:
operation: The operation to perform. Valid operations:
Team Members:
- create_team_member
- bulk_create_team_members
- update_team_member
- retrieve_team_member
- search_team_members
Wages:
- retrieve_wage_setting
- update_wage_setting
Labor:
- create_break_type
- create_shift
- search_shifts
- update_shift
- create_workweek_config
Cash Drawers:
- list_cash_drawer_shifts
- retrieve_cash_drawer_shift
params: Dictionary of parameters for the specific operation
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| operation | Yes | ||
| params | Yes |
Implementation Reference
- src/square_mcp/server.py:423-492 (handler)The 'team' tool handler function, registered via @mcp.tool() decorator. It dispatches to various Square API team management operations based on the 'operation' parameter using a match statement.@mcp.tool() async def team( operation: str, params: Dict[str, Any] ) -> Dict[str, Any]: """Manage team operations Args: operation: The operation to perform. Valid operations: Team Members: - create_team_member - bulk_create_team_members - update_team_member - retrieve_team_member - search_team_members Wages: - retrieve_wage_setting - update_wage_setting Labor: - create_break_type - create_shift - search_shifts - update_shift - create_workweek_config Cash Drawers: - list_cash_drawer_shifts - retrieve_cash_drawer_shift params: Dictionary of parameters for the specific operation """ try: match operation: # Team Members case "create_team_member": result = square_client.team.create_team_member(params) case "bulk_create_team_members": result = square_client.team.bulk_create_team_members(params) case "update_team_member": result = square_client.team.update_team_member(**params) case "retrieve_team_member": result = square_client.team.retrieve_team_member(**params) case "search_team_members": result = square_client.team.search_team_members(params) # Wages case "retrieve_wage_setting": result = square_client.labor.retrieve_wage_setting(**params) case "update_wage_setting": result = square_client.labor.update_wage_setting(**params) # Labor case "create_break_type": result = square_client.labor.create_break_type(params) case "create_shift": result = square_client.labor.create_shift(params) case "search_shifts": result = square_client.labor.search_shifts(params) case "update_shift": result = square_client.labor.update_shift(**params) case "create_workweek_config": result = square_client.labor.create_workweek_config(params) # Cash Drawers case "list_cash_drawer_shifts": result = square_client.cash_drawers.list_cash_drawer_shifts(**params) case "retrieve_cash_drawer_shift": result = square_client.cash_drawers.retrieve_cash_drawer_shift(**params) case _: raise McpError(INVALID_PARAMS, ErrorData(message=f"Invalid operation: {operation}")) return result.body except Exception as e: raise McpError(INTERNAL_ERROR, ErrorData(message=str(e)))
- src/square_mcp/server.py:423-423 (registration)The @mcp.tool() decorator registers the 'team' function as an MCP tool.@mcp.tool()