Behavr MCP server

behavr-mcp

An MCP server for BEHAVR. It gives an AI assistant two tools:

• remember: upload a local image or video to BEHAVR so it can be recalled later.
• ask: ask a question about everything remembered so far.

It runs locally over stdio. There is no hosted or HTTP mode.

Requirements

• Node.js 18 or newer
• A BEHAVR API key

Install

Optional variables (BEHAVRCLIENTID, BEHAVRAGENTID) are described under Configuration.

Claude Code

claude mcp add behavr -e BEHAVR_API_KEY=your-key -- npx -y behavr-mcp

On Windows (PowerShell):

claude mcp add behavr -e BEHAVR_API_KEY=your-key '--' npx -y behavr-mcp

In PowerShell, write the separator as '--' (in quotes), otherwise PowerShell drops it and the command fails with 'missing required argument commandOrUrl'.

Add -s user to make it available in every project. To share the setup with a team, use a project-level .mcp.json instead. Keep the key out of the file: Claude Code expands ${VAR} from your environment.

{
  "mcpServers": {
    "behavr": {
      "command": "npx",
      "args": ["-y", "behavr-mcp"],
      "env": {
        "BEHAVR_API_KEY": "${BEHAVR_API_KEY}",
        "BEHAVR_CLIENT_ID": "my-client"
      }
    }
  }
}

Cursor

Add this to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project). Do not commit a file that contains your key.

Cursor config is untested.

{
  "mcpServers": {
    "behavr": {
      "command": "npx",
      "args": ["-y", "behavr-mcp"],
      "env": {
        "BEHAVR_API_KEY": "your-key"
      }
    }
  }
}

Alternative: build from source

git clone https://github.com/confuse57/behavr-mcp.git
cd behavr-mcp
npm install && npm run build

The server entry point is dist/src/index.js (not dist/index.js). Run it with node instead of npx -y behavr-mcp:

claude mcp add behavr -e BEHAVR_API_KEY=your-key -- node /absolute/path/to/behavr-mcp/dist/src/index.js

claude mcp add behavr -e BEHAVR_API_KEY=your-key '--' node C:\path\to\behavr-mcp\dist\src\index.js

In .mcp.json or Cursor's mcp.json, use "command": "node" and "args": ["C:\\path\\to\\behavr-mcp\\dist\\src\\index.js"].

Windows paths in JSON

A backslash must be written twice inside a JSON string: "C:\\Users\\me\\behavr-mcp\\dist\\src\\index.js". Forward slashes also work: "C:/Users/me/behavr-mcp/dist/src/index.js". A single backslash ("C:\Users\...") is invalid JSON or silently turns into a different character.

Configuration

remember stores memories under the client and agent ids. ask searches the memories of all agents for the configured client, so two assistants with the same BEHAVRCLIENTID and different BEHAVRAGENTIDs can each find what the other saved.

The server prints only the client and agent ids to stderr at startup. The API key is never logged, and it is replaced with *** in any error message.

API key safety

• claude mcp add -e BEHAVRAPIKEY=... stores the key in plain text in Claude Code's config file, and the command can also end up in your shell history. Use a key dedicated to this server, and run claude mcp remove behavr when you no longer need it.
• Never put a real key in a shared project's .mcp.json. Use "${BEHAVRAPIKEY}" instead.
• In Cursor, put your key in mcp.json and do not commit that file to git.

Tools

remember

Input: { "file_path": "" }

Shortened. The full README is on GitHub.