obsei — Claude Code MCP server for customer feedback
obsei redacts personal data from customer feedback before an LLM processes it, then finds themes and gives agents cited evidence. Run it on your own infrastructure.
claude mcp add --env OBSEI_CONFIG=<OBSEI_CONFIG> --env OBSEI_DB=<OBSEI_DB> --env OBSEI_DB_KEY=<OBSEI_DB_KEY> --transport stdio obsei -- uvx obseiWhat obsei does
obsei processes customer feedback, removing personal data before an LLM sees it. It finds recurring themes and lets an AI agent answer questions with cited evidence. The service is self-hosted.
Use obsei add to configure sources and sinks, then run obsei check before obsei run. The obsei init command stores the database key and pseudonym salt in .obsei/secrets.env, a Git-ignored file accessible only to its owner. For servers and CI, set OBSEI_DB_KEY and OBSEI_PSEUDONYM_SALT or mount that file. Claude Code setup needs a database key; without it, the MCP server cannot be configured as shown.
What it helps with
- redact personal data from feedback before LLM processing
- surface recurring themes in customer feedback
- give agents answers backed by cited feedback
- configure feedback sources and sinks
Example prompts for the agent
- Find recurring themes in customer feedback and cite evidence for each one.
- Look for repeated complaints in the feedback and support the findings with citations.
- Answer my question using connected feedback sources and cite the evidence.
How to install obsei
Platform CLI
claude mcp add --env OBSEI_CONFIG=<OBSEI_CONFIG> --env OBSEI_DB=<OBSEI_DB> --env OBSEI_DB_KEY=<OBSEI_DB_KEY> --transport stdio obsei -- uvx obseiReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from obsei <command>
Platform CLI
codex mcp add obsei --env OBSEI_CONFIG=<OBSEI_CONFIG> --env OBSEI_DB=<OBSEI_DB> --env OBSEI_DB_KEY=<OBSEI_DB_KEY> -- uvx obseiReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from obsei <command>
Config file
{
"mcpServers": {
"obsei": {
"command": "uvx",
"args": [
"obsei"
],
"env": {
"OBSEI_CONFIG": "<OBSEI_CONFIG>",
"OBSEI_DB": "<OBSEI_DB>",
"OBSEI_DB_KEY": "<OBSEI_DB_KEY>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from obsei <command>
Config file
{
"servers": {
"obsei": {
"type": "stdio",
"command": "uvx",
"args": [
"obsei"
],
"env": {
"OBSEI_CONFIG": "<OBSEI_CONFIG>",
"OBSEI_DB": "<OBSEI_DB>",
"OBSEI_DB_KEY": "<OBSEI_DB_KEY>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from obsei <command>
Platform CLI
gemini mcp add -e OBSEI_CONFIG=<OBSEI_CONFIG> -e OBSEI_DB=<OBSEI_DB> -e OBSEI_DB_KEY=<OBSEI_DB_KEY> obsei uvx obseiReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from obsei <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about obsei
How do I install obsei in Claude Code?
Add the server with claude mcp add obsei -e OBSEI_DB_KEY=<OBSEI_DB_KEY> -- uvx obsei. Prepare the database key before configuring it.
What does obsei do?
It removes personal data from customer feedback before LLM processing, finds themes, and lets agents answer questions with cited evidence.
What do I need to configure obsei on a server?
Set OBSEI_DB_KEY and OBSEI_PSEUDONYM_SALT, or mount .obsei/secrets.env created by obsei init. Git ignores the file, and only its owner can access it.
