Skip to main content

Installation

Install the Tensorheart Memory MCP Server to give Claude persistent memory capabilities.

Prerequisites​

Before you begin, make sure you have:

Installation Steps​

1. Install via pip​

The easiest way to install the MCP server is using pip:

pip install tensorheart-memory-mcp

2. Verify Installation​

Check that the installation was successful:

python -m mcp_server --version

You should see output like:

Tensorheart Memory MCP v1.0.0

Alternative: Install from Source​

If you prefer to install from source:

# Clone the repository
git clone https://github.com/tensorheart/memory-mcp.git
cd memory-mcp/mcp_server

# Install dependencies
pip install -r requirements.txt

# Install in development mode
pip install -e .

Get Your API Key​

  1. Go to Tensorheart Memory Dashboard
  2. Navigate to API Keys
  3. Click Create New Key
  4. Copy your API key (it starts with mk_live_ or mk_test_)
Keep Your API Key Secret

Never share your API key or commit it to version control. Anyone with your API key can access your memories.

Next Steps​

Now that you've installed the MCP server, proceed to Configuration to set it up with Claude Desktop.

Troubleshooting​

Python Version Issues​

If you get an error about Python version:

# Check your Python version
python --version

# If you have multiple Python versions installed
python3.11 --version

Make sure you're using Python 3.11 or higher.

Permission Errors​

If you get permission errors during installation:

# Install for your user only
pip install --user tensorheart-memory-mcp

Installation Hangs​

If the installation seems to hang:

# Use verbose mode to see what's happening
pip install -v tensorheart-memory-mcp

Still Having Issues?​