hebbianvault-mcp (Python)

Python sibling of @hebbianvault/mcp. Connect a Python MCP host to your Hebbian workspace with the same 9 tools and the same configuration. A thin client; all intelligence and access control live in the Hebbian service.

Quick start

pip install hebbianvault-mcp
# or with uv (preferred)
uv add hebbianvault-mcp

Generate a token from your Hebbian integrations page (AI Tools tab → Generate token).

Configuration

Set HEBBIAN_API_TOKEN (or HEBBIAN_TOKEN) env var:

HEBBIAN_API_TOKEN=your_token_here hebbian-mcp

Or write ~/.config/hebbian/mcp-tenant.json:

{
  "token": "your_token_here"
}

Variable	Purpose
`HEBBIAN_API_TOKEN`	Your token (required). `HEBBIAN_TOKEN` is also accepted.
`HEBBIAN_API_URL`	Override the API base URL (Enterprise self-host). Defaults to the Hebbian SaaS API.
`HEBBIAN_TENANT`	Optional workspace slug — only needed if your account belongs to more than one workspace.

Generic agent config

import os
os.environ["HEBBIAN_API_TOKEN"] = "your_token_here"
from hebbianvault_mcp import create_server
server = create_server()
# server.run() to start serving over stdio

Token scope

Your token decides what the adapter can see and do — a personal-workspace token gives access to your own knowledge; a company-workspace token gives access to the shared company workspace (where your role allows). Scope is decided by the Hebbian service.

Tools

Tool	What it does
`hebbian_read_node`	Read a single node by UUID
`hebbian_search`	Find nodes in your workspace matching a query
`hebbian_ask`	Ask a question and get an answer backed by source quotes
`hebbian_context`	Describe a task and a token budget, get back a salience-ranked context pack that fits
`hebbian_capture`	Write a note into your workspace
`hebbian_traverse`	Explore nodes connected to a starting node
`hebbian_provenance`	See where a node's knowledge came from
`hebbian_salience`	See a node's recent activity over time
`hebbian_recent_activity`	Catch up on recent changes in your workspace

Results only ever include what your token is allowed to see.

Development

uv venv && uv pip install -e ".[dev]"
pytest
ruff check src/ tests/

Node.js version

The canonical package is @hebbianvault/mcp on npm. This Python sibling has identical tools and configuration. Use whichever matches your MCP host environment.

License

Apache-2.0. See the root LICENSE file.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

hebbianvault_mcp-0.3.0.tar.gz (59.2 kB view details)

Uploaded Jul 16, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

hebbianvault_mcp-0.3.0-py3-none-any.whl (14.8 kB view details)

Uploaded Jul 16, 2026 Python 3

File details

Details for the file hebbianvault_mcp-0.3.0.tar.gz.

File metadata

Download URL: hebbianvault_mcp-0.3.0.tar.gz
Upload date: Jul 16, 2026
Size: 59.2 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for hebbianvault_mcp-0.3.0.tar.gz
Algorithm	Hash digest
SHA256	`4b37840e2dbd46bb1a045a6876f5d6bd549a7f947f2582f52a3e9fd558dd6039`
MD5	`506c9e101d8c9d21d892b233d4b5ddd0`
BLAKE2b-256	`d57a0b6bad18ea8655af65027ed37b38caea05bcfe7f80cb4edc0e136878597d`

See more details on using hashes here.

Provenance

The following attestation bundles were made for hebbianvault_mcp-0.3.0.tar.gz:

Publisher: release.yml on hebbianvault/hebbian-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: hebbianvault_mcp-0.3.0.tar.gz
- Subject digest: 4b37840e2dbd46bb1a045a6876f5d6bd549a7f947f2582f52a3e9fd558dd6039
- Sigstore transparency entry: 2186882077
- Sigstore integration time: Jul 16, 2026
Source repository:
- Permalink: hebbianvault/hebbian-mcp@c0e7730bd8ba7b2b9fba14278254fbcf72bab0f3
- Branch / Tag: refs/tags/v0.3.0
- Owner: https://github.com/hebbianvault
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: self-hosted
- Publication workflow: release.yml@c0e7730bd8ba7b2b9fba14278254fbcf72bab0f3
- Trigger Event: push