# Noetive

Noetive lets agents store knowledge in a shared namespace and retrieve it by meaning. Use it when separate sessions need access to what other agents have learned.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 2
- Author: noetive
- License: ISC · policy=link-only · description only; the file stays with the author
- Source: https://github.com/noetive/noetive-mcp
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/mcp/noetive

## What it does

The server connects an editor to Noetive Semantik. Agents can add learned information to a namespace, then search for material contributed by peers without relying on matching topic labels. Set a namespace to route calls to the intended collection.

You need the `NOETIVE_KEY_SECRET` API key. Without it, the server exposes only `noetive_health`. Run `npx @noetive/mcp-server init` to configure a detected editor and provide settings such as the key and namespace. To inspect the binary, credentials, and editor configuration, run `npx @noetive/mcp-server doctor`.

An OpenAI-compatible `/v1/embeddings` endpoint can handle embedding on your own machine. Note that `Kiro` and `Codex` do not expand variables in their MCP configuration, so their key must be entered directly.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `NOETIVE_KEY_SECRET`, `NOETIVE_NAMESPACE`, `NOETIVE_MODEL`, `NOETIVE_DIMENSIONS`, `NOETIVE_DISABLE_GLOBAL_NS`, `NOETIVE_EMBEDDINGS_URL`, `NOETIVE_EMBEDDINGS_KEY_SECRET` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env NOETIVE_KEY_SECRET=<NOETIVE_KEY_SECRET> --env NOETIVE_NAMESPACE=<NOETIVE_NAMESPACE> --env NOETIVE_MODEL=<NOETIVE_MODEL> --env NOETIVE_DIMENSIONS=<NOETIVE_DIMENSIONS> --env NOETIVE_DISABLE_GLOBAL_NS=<NOETIVE_DISABLE_GLOBAL_NS> --transport stdio noetive -- npx -y @noetive/mcp-server
```
Replace <…> with your own values. 2 more environment variables are in the server README

### Codex

**Platform CLI**
```bash
codex mcp add noetive --env NOETIVE_KEY_SECRET=<NOETIVE_KEY_SECRET> --env NOETIVE_NAMESPACE=<NOETIVE_NAMESPACE> --env NOETIVE_MODEL=<NOETIVE_MODEL> --env NOETIVE_DIMENSIONS=<NOETIVE_DIMENSIONS> --env NOETIVE_DISABLE_GLOBAL_NS=<NOETIVE_DISABLE_GLOBAL_NS> -- npx -y @noetive/mcp-server
```
Replace <…> with your own values. 2 more environment variables are in the server README

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "noetive": {
            "command": "npx",
            "args": [
                "-y",
                "@noetive/mcp-server"
            ],
            "env": {
                "NOETIVE_KEY_SECRET": "<NOETIVE_KEY_SECRET>",
                "NOETIVE_NAMESPACE": "<NOETIVE_NAMESPACE>",
                "NOETIVE_MODEL": "<NOETIVE_MODEL>",
                "NOETIVE_DIMENSIONS": "<NOETIVE_DIMENSIONS>",
                "NOETIVE_DISABLE_GLOBAL_NS": "<NOETIVE_DISABLE_GLOBAL_NS>"
            }
        }
    }
}
```
Replace <…> with your own values. 2 more environment variables are in the server README

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "noetive": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@noetive/mcp-server"
            ],
            "env": {
                "NOETIVE_KEY_SECRET": "<NOETIVE_KEY_SECRET>",
                "NOETIVE_NAMESPACE": "<NOETIVE_NAMESPACE>",
                "NOETIVE_MODEL": "<NOETIVE_MODEL>",
                "NOETIVE_DIMENSIONS": "<NOETIVE_DIMENSIONS>",
                "NOETIVE_DISABLE_GLOBAL_NS": "<NOETIVE_DISABLE_GLOBAL_NS>"
            }
        }
    }
}
```
Replace <…> with your own values. 2 more environment variables are in the server README

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e NOETIVE_KEY_SECRET=<NOETIVE_KEY_SECRET> -e NOETIVE_NAMESPACE=<NOETIVE_NAMESPACE> -e NOETIVE_MODEL=<NOETIVE_MODEL> -e NOETIVE_DIMENSIONS=<NOETIVE_DIMENSIONS> -e NOETIVE_DISABLE_GLOBAL_NS=<NOETIVE_DISABLE_GLOBAL_NS> noetive npx -y @noetive/mcp-server
```
Replace <…> with your own values. 2 more environment variables are in the server README

## When to use it
- store an agent's findings in a shared namespace
- retrieve other agents' knowledge by meaning
- route calls to a chosen namespace
- check the server setup and API key

## Example prompts
- Save this finding to the `acme-platform` namespace so other agents can retrieve it.
- Search for what other agents learned about configuring `acme-platform`.
- Check the Noetive connection by calling `noetive_health`.

## Similar
- [agent-knowledge](https://affpapa.org/en/nevibecode/plugins/agent-knowledge.md) — plugin · ★ 19
- [firecrawl-research-index](https://affpapa.org/en/nevibecode/skills/firecrawl-research-index.md) — skill · 24400 installs
- [agent-memory-systems](https://affpapa.org/en/nevibecode/skills/agent-memory-systems.md) — skill · 1086 installs
- [honcho-integration](https://affpapa.org/en/nevibecode/skills/honcho-integration.md) — skill · 883 installs
- [neo4j-agent-memory-skill](https://affpapa.org/en/nevibecode/skills/neo4j-agent-memory-skill.md) — skill · 879 installs
- [exa-search](https://affpapa.org/en/nevibecode/skills/exa-labs-exa-search.md) — skill · 1400 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md