Back to Directory/Analytics & BI

io.github.lewo-media/safe-mind

Psychological risk assessments (GBU Psyche) via Safe Mind: surveys, departments, analytics.

Analytics & BITypeScriptv0.1.2

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.

PackagenpmPurpose
cli/safe-mindTerminal client for the Safe Mind Public API v1
mcp/safe-mind-mcpMCP server for AI assistants (Claude, ChatGPT, Gemini, Cursor, ...)

Quick start

npm install -g safe-mind
safe-mind login --email you@example.com --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

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
npx -y safe-mind-mcp

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-lewo-media-safe-mind": {
      "command": "npx",
      "args": [
        "-y",
        "safe-mind-mcp"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

safe-mind-mcpnpm

Compatible MCP Clients

io.github.lewo-media/safe-mind works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More