The notebare MCP server lets you search your facts directly from Claude Code using the Model Context Protocol. Once configured, Claude can query your notebare knowledge base during conversations.

Prerequisites

1. Python 3.10 or later
2. Claude Code installed and working
3. A notebare.com account with at least one fact saved

Step 1 — Create an API Token

Log in to notebare.com, go to Projects, and scroll down to the API Tokens section. Create a token and copy it immediately — it won't be shown again.

Step 2 — Install the MCP Server

Clone the repo and install dependencies into a virtualenv:

git clone https://github.com/gordonmurray/notebare_com_mcp.git
cd notebare_com_mcp
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Step 3 — Configure .mcp.json

Add the following to your project's .mcp.json (or ~/.claude/.mcp.json for global access). Replace the placeholders with your actual values:

{
  "mcpServers": {
    "notebare-facts": {
      "command": "/path/to/notebare_com_mcp/.venv/bin/python",
      "args": ["/path/to/notebare_com_mcp/server.py"],
      "env": {
        "NOTEBARE_API_TOKEN": "nb_your_token_here",
        "NOTEBARE_API_URL": "https://api.notebare.com"
      }
    }
  }
}

Step 4 — Verify

Restart Claude Code. You should see the notebare-facts MCP server connect. Check that the two tools are available:

# In Claude Code, ask:
"List my notebare domains"
"Search my notebare facts about terraform"

Available Tools