SerialMemory MCP Client

February 11, 2026 · View on GitHub

Official Model Context Protocol (MCP) client for the SerialMemory Cloud Platform.
Compatible with Claude Desktop, Cursor, Kilo Code, and any MCP-enabled IDE.

Release

🚀 Overview

The SerialMemory MCP Client is a thin, stateless proxy that forwards MCP tool calls to:

https://api.serialmemory.dev/api/mcp/tools/

It contains zero backend logic — all intelligence happens on SerialMemory Cloud.

📦 Installation

1. Download Binary

➡️ https://github.com/sblanchard/SerialMemory-MCP/releases

Windows: serialmemory-mcp-win-x64.zip
macOS ARM: serialmemory-mcp-macos-arm64.tar.gz
Linux: serialmemory-mcp-linux-x64.tar.gz

Extract anywhere.

⚙️ Configuration

Linux / macOS

export SERIALMEMORY_ENDPOINT="https://api.serialmemory.dev"
export SERIALMEMORY_API_KEY="your-api-key"

Windows PowerShell

setx SERIALMEMORY_ENDPOINT "https://api.serialmemory.dev"
setx SERIALMEMORY_API_KEY "your-api-key"

Get your API key from:
https://app.serialmemory.dev/dashboard

▶️ Running

Direct execution

./serialmemory-mcp

Docker

docker run -it \
  -e SERIALMEMORY_ENDPOINT="https://api.serialmemory.dev" \
  -e SERIALMEMORY_API_KEY="your-api-key" \
  serialcoder/serialmemory-mcp:latest

🔌 MCP Integration

Claude Desktop

Modify:

~/Library/Application Support/Claude/claude_desktop_config.json

Add:

{
  "mcpServers": {
    "serialmemory": {
      "command": "/path/to/serialmemory-mcp"
    }
  }
}

Restart Claude.

Cursor

~/.cursor/mcp.json

{
  "serialmemory": {
    "command": "/path/to/serialmemory-mcp"
  }
}

Kilo Code

~/.kilocode/mcp.json

{
  "servers": {
    "serialmemory": {
      "command": "/path/to/serialmemory-mcp"
    }
  }
}

🧩 Tools

Tool	Description
memory.search	Semantic & keyword search
memory.add	Add a memory item
memory.update	Update an existing memory
memory.delete	Remove a memory
memory.list_recent	Recently added memories
session.list	Conversation sessions
graph.query	Knowledge-graph query

All calls proxy to:
POST /api/mcp/tools/<toolName>

🏗 Development

git clone https://github.com/sblanchard/SerialMemory-MCP
cd SerialMemory-MCP
dotnet build
dotnet run --project SerialMemory.Mcp

🐳 Dockerfile (included)

FROM mcr.microsoft.com/dotnet/runtime:10.0
WORKDIR /app
COPY . .
ENTRYPOINT ["./serialmemory-mcp"]

🔧 Troubleshooting

Mac: SSE Transport Authentication Fails

Error:

HTTP 404: Invalid OAuth error response: SyntaxError: JSON Parse error: Unexpected EOF. Raw body:

Cause: The MCP SDK on Mac with SSE transport performs OAuth discovery, hitting /.well-known/oauth-authorization-server. If this returns 404 with an empty body, JSON parsing fails.

Solution: Use http transport instead of sse:

{
  "mcpServers": {
    "serialmemory": {
      "type": "http",
      "url": "http://localhost:4545/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

This works on all platforms (Windows, Linux, macOS).

🔐 Security

No local storage
No embeddings
No database access
Pure HTTPS proxy
Safe in enterprise environments

🗒 Changelog

v1.0.0

First public release
Claude, Cursor, Kilo Code support
Docker build
Multi-OS support
Stateless MCP proxy