veriova-mcp

MCP Server for veriova-Give Claude, Codex, and Cursor persistent memory across sessions.

Quick Setup

Universal Interactive Setup (Recommended)

npx veriova-mcp setup

This prompts for target assistant (codex, claude-code, claude-desktop, cursor, or all) and your API key. It will then fetch your projects and let you pick one (defaults to a slug derived from the current folder name). If you do not have an API key yet, type open at the API key prompt and it opens https://veriova.com/signup.

Interactive Login (No API key paste)

You can login with magic link and store a local session profile:

npx veriova-mcp login

Then manage projects interactively:

npx veriova-mcp projects
npx veriova-mcp use your-project --sync-default
npx veriova-mcp sync

This stores local profile state in ~/.config/veriova/mcp.json (or $XDG_CONFIG_HOME/veriova/mcp.json). Credentials are stored in OS keychain when available (macOS Keychain or Linux Secret Service), with file fallback only if keychain is unavailable.

You can also target one assistant directly:

npx veriova-mcp setup codex
npx veriova-mcp setup claude-code
npx veriova-mcp setup claude-desktop
npx veriova-mcp setup cursor

Codex (Manual)

codex mcp add veriova \
  --env VERIOVA_API_KEY=cv_your_key \
  --env VERIOVA_PROJECT=your-project \
  --env VERIOVA_BASE_URL=https://veriova.com \
  -- npx veriova-mcp

Claude Code (CLI)

Use the universal setup (recommended), or add with JSON (more reliable than -e flags):

claude mcp add-json -s user veriova '{"command":"npx","args":["veriova-mcp"],"env":{"VERIOVA_API_KEY":"cv_your_key","VERIOVA_PROJECT":"your-project","VERIOVA_BASE_URL":"https://veriova.com"}}'

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "veriova": {
      "command": "npx",
      "args": ["veriova-mcp"],
      "env": {
        "VERIOVA_API_KEY": "cv_your_key",
        "VERIOVA_PROJECT": "your-project",
        "VERIOVA_BASE_URL": "https://veriova.com"
      }
    }
  }
}

Cursor

Add to Cursor MCP settings with the same config as Claude Desktop. If the Cursor CLI install fails on your machine, veriova-mcp setup cursor falls back to writing a local config file:

// .cursor/mcp.json
{
  "mcpServers": {
    "veriova": {
      "command": "npx",
      "args": ["veriova-mcp"],
      "env": {
        "VERIOVA_API_KEY": "cv_your_key",
        "VERIOVA_PROJECT": "your-project",
        "VERIOVA_BASE_URL": "https://veriova.com"
      }
    }
  }
}

It also adds .cursor/ to .gitignore so you don--�t accidentally commit secrets.

Get Your API Key

1. Go to veriova
2. Sign up with your email (passwordless magic link)
3. Save the API key and project slug

Tools

Once connected, your AI assistant gets memory + account/project tools:

| Tool | Description | |------|-------------| | veriova_remember | Store a decision, convention, pattern, or lesson | | veriova_recall | Search memory for relevant context | | veriova_context | Get a full context pack for a topic | | veriova_list | List all memory items | | veriova_whoami | Show identity, role, scope, and accessible projects | | veriova_projects | List projects available to the current API key | | veriova_project_current | Show session active project, env project, and cloud default | | veriova_project_use | Switch project for this MCP session; optionally sync cloud default | | veriova_project_create | Create a project and optionally activate/sync it | | veriova_project_update | Update project name/description |

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | VERIOVA_API_KEY | No | API key (starts with cv_) | | VERIOVA_SESSION | No | Session token (cv_session) from magic-link verify | | VERIOVA_PROJECT | No | Project slug override. If omitted, MCP resolves from cloud default/available projects. | | VERIOVA_BASE_URL | No | API base URL (defaults to https://veriova.com) |

At least one of VERIOVA_API_KEY or VERIOVA_SESSION is required. If neither is set, MCP falls back to local saved login profile.

Troubleshooting

Validate your config:

npx veriova-mcp doctor

Inside your assistant, run:

1. veriova_projects to see available slugs
2. veriova_project_use with the chosen slug
3. veriova_project_current to confirm active/default alignment

Reset local auth:

npx veriova-mcp logout

License

MIT