# obsei

> Ask your agent what customers are saying: self-hosted feedback with PII redacted at ingest, answered with cited quotes and themes.

obsei is an open-source, self-hosted tool for collecting and analysing customer feedback. It pulls in reviews, tickets, surveys and community posts in many languages, redacts personal data before anything is stored, labels it and groups it into themes, all in an encrypted database on your own machine or servers. Its MCP server lets your agent answer questions about that feedback with quotes you can check.

What you can do with it
- Ask what customers are talking about and see the recurring themes, with which ones are rising
- Size a question with counts and average rating by source, sentiment, intent, language, rating, day, week or month
- Pull evidence: matching feedback, newest first, quoted in its own language with a record id for each quote
- Check a citation by fetching the record it came from
- Propose a GitHub, Jira or Linear issue backed by the feedback, which waits for a person to approve it

Where the feedback comes from
You set up pipelines with the obsei command line (obsei init, obsei add, obsei run). Sources include App Store and Google Play reviews, Zendesk, Freshdesk, Intercom, Gong, GitHub issues, Hacker News, Bluesky, YouTube, RSS, email inboxes, SQL databases, CSV files and REST APIs. Labels come from a classifier that runs on your machine, or from a model you choose.

How it connects
The MCP server runs on your machine with uv: uvx --from "obsei>=1.0" obsei mcp. It reads obsei.yaml in the folder it starts in, or the file named by OBSEI_CONFIG (use an absolute path). Set OBSEI_DB for a database kept elsewhere, and OBSEI_DB_KEY when the key isn't in the .obsei/secrets.env file that obsei init writes beside obsei.yaml. The first start downloads obsei and can take a minute. obsei also offers a Claude Code plugin and a Gemini CLI extension that add a voice-of-customer skill, and obsei serve offers the same tools over HTTP behind a token.

Good to know
- Set up obsei and run a pipeline first: the server answers from feedback obsei has already stored.
- The four read tools change nothing. propose_issue only queues a proposal inside obsei; a person approves it with obsei approvals before any issue is opened.
- Emails, phone numbers, cards, IBANs and national IDs are redacted and authors are pseudonymised at ingest, and results never include the pseudonyms.
- Feedback text is marked untrusted, and the server tells agents to quote it and never follow instructions inside it.
- Open source under Apache-2.0, with no telemetry.

- Type: Plugin
- Made by: obsei
- Category: Customer support
- Formats: Local MCP
- Version: 1.1.1
- Website: https://obsei.com/
- Source: https://github.com/obsei/obsei/tree/HEAD/packages/obsei
- Page: https://pluginboard.ai/plugins/obsei

## Works with

- Claude
- GitHub Copilot
- Cursor
- Claude Code
- Codex
- Antigravity
- Gemini CLI
- OpenClaw
- OpenCode
- Hermes Agent

## Install

You'll need:

- `OBSEI_CONFIG` (optional): Path to obsei.yaml (default ./obsei.yaml).
- `OBSEI_DB` (optional): Path to the database, overriding store.path.
- `OBSEI_DB_KEY` (optional): The key that encrypts the database.

Replace each `<NAME>` placeholder with your own value.

### Claude

Add to claude_desktop_config.json:

```json
{
  "mcpServers": {
    "obsei": {
      "command": "uvx",
      "args": [
        "obsei==1.1.1",
        "mcp"
      ]
    }
  }
}
```

### GitHub Copilot

Add to VS Code: vscode:mcp/install?%7B%22name%22%3A%22obsei%22%2C%22command%22%3A%22uvx%22%2C%22args%22%3A%5B%22obsei%3D%3D1.1.1%22%2C%22mcp%22%5D%7D

Run in your terminal:

```shell
code --add-mcp '{"name":"obsei","command":"uvx","args":["obsei==1.1.1","mcp"]}'
```

Copilot CLI:

```shell
copilot mcp add obsei -- uvx obsei==1.1.1 mcp
```

### Cursor

Add to Cursor: cursor://anysphere.cursor-deeplink/mcp/install?name=obsei&config=eyJjb21tYW5kIjoidXZ4IiwiYXJncyI6WyJvYnNlaT09MS4xLjEiLCJtY3AiXX0%3D

Add to .cursor/mcp.json:

```json
{
  "mcpServers": {
    "obsei": {
      "command": "uvx",
      "args": [
        "obsei==1.1.1",
        "mcp"
      ]
    }
  }
}
```

### Claude Code

Run in your terminal:

```shell
claude mcp add obsei -- uvx obsei==1.1.1 mcp
```

### Codex

Run in your terminal:

```shell
codex mcp add obsei -- uvx obsei==1.1.1 mcp
```

### Antigravity

Add to ~/.gemini/config/mcp_config.json:

```json
{
  "mcpServers": {
    "obsei": {
      "command": "uvx",
      "args": [
        "obsei==1.1.1",
        "mcp"
      ]
    }
  }
}
```

### Gemini CLI

Run in your terminal:

```shell
gemini mcp add obsei uvx obsei==1.1.1 mcp
```

### OpenClaw

In a terminal: Run openclaw mcp add obsei --command uvx, with --arg before each argument (obsei==1.1.1 mcp) and --env NAME=value for each variable it needs.

### OpenCode

Run in your terminal:

```shell
opencode mcp add obsei -- uvx obsei==1.1.1 mcp
```

### Hermes Agent

Add to ~/.hermes/config.yaml:

```json
{
  "mcp_servers": {
    "obsei": {
      "command": "uvx",
      "args": [
        "obsei==1.1.1",
        "mcp"
      ]
    }
  }
}
```

---
From Pluginboard (https://pluginboard.ai).