SAP SuccessFactors MCP server

SuccessFactors Toolkit

A self-hosted toolkit for SAP SuccessFactors API troubleshooting, payload extraction, and integration development, exposed as a REST API and as an MCP (Model Context Protocol) server.

OData v4 covers the SuccessFactors APIs published as v4 services (for example Calibration and Continuous Feedback); Employee Central and Onboarding data stay on v2. See OData API.

This is an independent project, not affiliated with or endorsed by SAP SE. SAP and SuccessFactors are trademarks of SAP SE.

Start here: Docker MCP → credentials → ask → export

Data security: prefer local deployment. For sensitive SuccessFactors

employee data and credentials, we recommend running the MCP server in local

Docker and using a local AI agent, rather than an online AI platform or a

third-party hosted MCP service. Keep credentials and exports on your machine;

do not upload private keys or employee payloads to online platforms.

A local AI agent is not necessarily a local model. If it calls a cloud

model, prompts, tool responses, previews, and file contents supplied to that

model may leave your machine. If HR data must stay within your controlled

environment, use a locally hosted model and local file-processing tools,

and check the agent's outbound data handling. Local Docker alone does not

guarantee this. The toolkit still connects to your configured SuccessFactors

tenant to query data.

For functional consultants and business key users, start with the business user guide or its English/Chinese HTML edition. Ask IT to complete the one-time Docker Compose setup and provide approved connection files. Then:

and information you need.

1. Check Docker Desktop or your IT-managed Docker service is running, then open your local AI application.
2. Confirm with IT that the connection files are in sf-toolkit/credentials.
3. Confirm the SuccessFactors environment and ask for the employee, date,

for CSV or another supported format, or a copy in an authorized folder.

1. Find results under sf-toolkit/data/mcp. Ask a file-capable AI application

The guide includes example business questions, completion checks, troubleshooting, and expandable one-time settings for your administrator. Original OData results are JSON; Compound Employee results are XML. CSV conversion requires local file tools in the AI application.

Documentation

Data handling

Shortened. The full README is on GitHub.