Skip to main content

​
IDEs & Agents — MCP Server

Memwyre provides a fully compliant Model Context Protocol (MCP) server. This lets your local AI agents, code editors, and desktop apps seamlessly read from and write to your Memwyre vault.

​
Overview

The Model Context Protocol is an open standard that connects AI systems with external tools and data sources. By running the Memwyre MCP Server locally, you give your IDE or agent (Claude Desktop, Cursor, VS Code, etc.) direct access to your centralised memory — no more copy-pasting context manually.

​
Prerequisites

Before you begin, make sure you have:
  • Python 3.10+ installed on your machine.
  • Your MEMWYRE_API_KEY — generate one from Settings → API Keys in the Memwyre web app.
  • The mcp_server.py script downloaded to a permanent location on your hard drive.

​
Connection Protocols

Memwyre supports two connection protocols for Model Context Protocol (MCP):
  1. Remote HTTP Tunneling (Recommended): Utilizes the mcp-remote utility to tunnel commands to our secure cloud endpoint (https://server.memwyre.tech/mcp).
  2. Local Python Execution: Runs the mcp_server.py file locally on your machine using Python, executing local SQLite vector updates.

​
Setup Configurations

​
1. Claude Desktop (Remote)

Add this server block to your Claude configuration file:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

​
2. VS Code & Cursor (Remote)

In your IDE settings panel, register the MCP server as:
  • Command: npx
  • Args: ["-y", "mcp-remote", "https://server.memwyre.tech/mcp", "--header", "Authorization:Bearer your_token_here"]

​
3. Local Python Script Setup

If running fully self-hosted, download mcp_server.py and invoke it directly:

​
Available Tools

Once connected, your IDE or agent will have access to the following tools:

​
Troubleshooting

Claude Desktop doesn’t show the Memwyre tools.
Check that the command path resolves correctly — try python3 instead of python on macOS/Linux if deploying local scripts, or confirm your npx command executes correctly in your shell. MEMWYRE_API_KEY environment variable not found.
For local server python deployments, ensure the key is set inside the env block of your config file, not as a system environment variable. For remote instances, ensure your Bearer token in the header argument is valid.