safe-mind

Name: safe-mind
Author: lewo-media

Local

github.com/lewo-mediaHealth0Updated 2w ago

Repository

About safe-mind

safe-mind provides developer tools for Safe Mind, Germany's platform for legally required psychological risk assessments. Its CLI and MCP server support survey and department workflows and access to aggregated analytics.

Key features

01CLI for the Safe Mind Public API v1
02MCP server for AI assistants
03Create surveys with date and duration settings
04Specify employee counts and departments
05Aggregated analytics with small-group filtering

Use cases

01Create a psychological risk assessment survey
02Set survey periods and employee counts
03Organize assessments by department
04Review aggregated analytics while filtering small groups

MCP support

The MCP server connects AI assistants to Safe Mind tools. Analytics endpoints return aggregated results, with groups below the minimum size filtered server-side.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config

{
  "mcpServers": {
    "lewo-media-safe-mind": {
      "command": "npx",
      "args": [
        "-y",
        "safe-mind-mcp"
      ],
      "env": {
        "SAFE_MIND_API_KEY": "<SAFE_MIND_API_KEY>"
      }
    }
  }
}

Run commandnpx -y safe-mind-mcp

Environment variables to set

SAFE_MIND_API_KEYSecretSafe Mind API key (sm_live_...). Optional - the safe_mind_register and safe_mind_get_api_key tools can onboard a new account without it.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages

npmsafe-mind-mcp0.1.2stdio

Tools

Saved tool list · updated 1w ago

Parameter	Type	Required
email	string	Yes
lastName	string	Yes
password	string	Yes
firstName	string	Yes
companyName	string	Yes
employeeCount	integer	Yes

Details

From the project README

Safe Mind Developer Tools

Official CLI and MCP server for Safe Mind - the platform for the legally required psychological risk assessment (Gefährdungsbeurteilung psychischer Belastung, GBU Psyche) in Germany.

Package	npm	Purpose
`cli/`	safe-mind	Terminal client for the Safe Mind Public API v1
`mcp/`	safe-mind-mcp	MCP server for AI assistants (Claude, ChatGPT, Gemini, Cursor, ...)

Quick start

npm install -g safe-mind
safe-mind login --email [email protected] --password '...'
safe-mind surveys create --start 2026-10-01 --weeks 4 --employees 220 \
  --department "Produktion" --department "Verwaltung"

MCP (any MCP client):

{
    "mcpServers": {
        "safe-mind": {
            "command": "npx",
            "args": ["-y", "safe-mind-mcp"],
            "env": { "SAFE_MIND_API_KEY": "sm_live_..." }
        }
    }
}

Documentation

API reference and examples: https://www.safe-mind.de/developers
Anonymity: analytics endpoints only return aggregated results; groups below the minimum group size are filtered server-side.

License

MIT

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

Read the getting-started guide

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.