@cogniahq/mcp

End-to-end encrypted memory for Claude Desktop, Cursor, Zed, Cline, and any MCP-compatible client. Bring your own OpenAI key. Open source under MIT.

npx -y @cogniahq/mcp init YOUR_COGNIA_API_KEY

That prints the config block you paste into Claude Desktop, Cursor, or Zed. Restart the client and your AI assistant can query your Cognia workspace as a native tool.

What this is

A Model Context Protocol server that exposes your Cognia memory to any MCP client. Your assistant can search, retrieve, and act against decisions, notes, documents, and integrations you've connected to Cognia (Slack, Notion, Linear, Jira, GitHub, Drive, and more).

It is the client-side surface. The backend it talks to is end-to-end encrypted at rest with per-org keypairs (libsodium Argon2id); the database holds only ciphertext. With BYOK enabled, your prompts and embeddings go to your OpenAI account on your contract, not ours. Threat model is public at https://cogniahq.tech/security.

Tools exposed

| Tool | What it does | | --- | --- | | cognia_search | Hybrid (dense + sparse BM25) search with cross-encoder reranking | | cognia_get_memory | Fetch the full content of a single memory by id | | cognia_list_memories | Paginated chronological listing, optional substring filter | | cognia_action_plan | Draft an integration action (e.g. create a calendar event) | | cognia_action_execute | Execute a previously drafted action |

Mutating actions are drafted first by default. Execution is a separate tool call so the assistant cannot silently change your external systems.

Install

Claude Desktop

// ~/Library/Application Support/Claude/claude_desktop_config.json  (macOS)
// %APPDATA%\Claude\claude_desktop_config.json                       (Windows)
{
  "mcpServers": {
    "cognia": {
      "command": "npx",
      "args": ["-y", "@cogniahq/mcp"],
      "env": { "COGNIA_API_KEY": "ck_live_..." }
    }
  }
}

Cursor

// ~/.cursor/mcp.json  (or .cursor/mcp.json in your repo for project-scoped)
{
  "mcpServers": {
    "cognia": {
      "command": "npx",
      "args": ["-y", "@cogniahq/mcp"],
      "env": { "COGNIA_API_KEY": "ck_live_..." }
    }
  }
}

Zed

// ~/.config/zed/settings.json
{
  "context_servers": {
    "cognia": {
      "command": { "path": "npx", "args": ["-y", "@cogniahq/mcp"] },
      "env": { "COGNIA_API_KEY": "ck_live_..." }
    }
  }
}

Restart your client. Your assistant now has Cognia tools.

Don't want to remember the JSON? Run npx -y @cogniahq/mcp init and it prints all three blocks with your API key inlined.

Getting an API key

1. Sign up at https://cogniahq.tech (free up to 5 seats, no card)
2. Open Settings → API keys
3. Create a key. Copy the ck_live_... value (shown once)

Environment variables

| Variable | Required | Default | | --- | --- | --- | | COGNIA_API_KEY | yes | — | | COGNIA_BASE_URL | no | https://api.cogniahq.tech | | COGNIA_TIMEOUT_MS | no | 30000 |

Use as a TypeScript client

The same package also exports a typed REST client if you want to build against the Cognia API without the MCP transport.

import { CogniaClient } from '@cogniahq/mcp/client'

const cognia = new CogniaClient({ apiKey: process.env.COGNIA_API_KEY! })

const hits = await cognia.search.query({ query: 'postgres migration decision', limit: 5 })
for (const hit of hits) {
  console.log(hit.title, hit.snippet)
}

Full surface: cognia.memories.list / iterate / retrieve / update / delete, cognia.search.query, cognia.actions.plan / retrieve / execute. Built-in retry with exponential backoff and Retry-After support.

Build from source

git clone https://github.com/cogniahq/cognia-mcp.git
cd cognia-mcp
npm install
npm run build
node dist/cli.js --help

Why open source

If you ship an MCP server that touches company knowledge, your security team will want to read it before approving the install. So we open-sourced ours. The encrypted backend, search pipeline, and admin console stay closed. The surface that runs on your machine is right here.

The integrations SDK and a small cognia memory CLI will follow on the same MIT terms.

License

MIT. See LICENSE.

Links

• Cognia: https://cogniahq.tech
• API docs: https://cogniahq.tech/developers
• Security and threat model: https://cogniahq.tech/security
• Pricing: https://cogniahq.tech/pricing
• Issues: https://github.com/cogniahq/cognia-mcp/issues