📚 Soulcraft Memory Documentation

Complete guide to using Soulcraft Memory - AI memory with 17 powerful tools via Model Context Protocol (MCP).

🚀 Quick Start

Get started with Soulcraft Memory in under 5 minutes:

1. Sign in with Google or GitHub at memory.soulcraft.com/dashboard
2. Copy your API key from the dashboard
3. Choose your AI tool and follow the setup instructions
4. Start using the 17 tools - just talk naturally to Claude!

🤖 Smart Agent Detection & Context Loading

Soulcraft Memory automatically detects your AI agent and optimizes for your workflow!

💡 Common Use Cases

🛠️ All 17 MCP Tools

Soulcraft Memory provides 17 powerful tools organized into 5 categories. All tools work automatically when you talk naturally to Claude! 🆕 3 new tools for session continuity and personalization!

💬 Example Prompts for Each Tool

Below are detailed examples for all 17 tools. Just talk naturally - Claude will automatically use the right tool!

🧠 Memory Tools 6 tools

Store, search, and manage information that persists across all sessions.

✅ Todo Tools 3 tools

Create, manage, and track tasks that persist across all sessions.

🎯 Project Context Tools 2 tools

Set and track your current project for automatic organization.

💬 Conversation Intelligence Tools 3 tools

Search, analyze, and learn from past conversations.

🔄 Session Continuity & Personalization Tools 3 tools NEW!

Automatic session restoration and personalized AI experience. These tools work automatically!

⚙️ Setup Guides

Choose your AI coding tool below for specific setup instructions. Each tool has a different configuration approach.

🚀 Claude Code (Recommended: CLI Method)

Easiest setup! Claude Code is the only tool with native CLI commands for MCP configuration.

One-command setup:

claude mcp add --transport http soulcraft-memory \
  https://memory.soulcraft.com/mcp \
  -H "X-API-Key: YOUR_API_KEY_HERE" \
  -H "Accept: application/json"

Verify connection:

claude mcp list

Remove if needed:

claude mcp remove soulcraft-memory

{
  "mcpServers": {
    "soulcraft-memory": {
      "transport": "http",
      "url": "https://memory.soulcraft.com/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY_HERE"
      }
    }
  }
}

🖥️ Claude Desktop (GUI App)

For the Claude Desktop application (not Claude Code CLI):

Config file location:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Configuration:

{
  "mcpServers": {
    "soulcraft-memory": {
      "command": "npx",
      "args": ["-y", "@soulcraft/mcp-server"],
      "env": {
        "SOULCRAFT_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Important: Completely quit and restart Claude Desktop after editing (not just refresh).

📱 Claude Mobile (iOS/Android)

Configure MCP servers in Claude Desktop or on claude.ai/settings, then your settings automatically sync to the mobile app!

🎯 Cursor

Config file location:

• All platforms: .cursor/mcp.json in your project root, or
• Global: ~/.cursor/mcp.json

Configuration:

{
  "mcpServers": {
    "soulcraft-memory": {
      "transport": "http",
      "url": "https://memory.soulcraft.com/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Restart Cursor after saving.

🌊 Windsurf (Codeium)

Config file location:

• macOS/Linux: ~/.codeium/windsurf/mcp_config.json
• Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json

Configuration:

{
  "mcp_servers": {
    "soulcraft-memory": {
      "command": "npx",
      "args": ["-y", "@soulcraft/mcp-server"],
      "env": {
        "SOULCRAFT_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Restart Windsurf after saving.

💻 GitHub Copilot (VS Code)

Option 1: VS Code Settings UI

1. Open VS Code Settings (Cmd/Ctrl + ,)
2. Search for "copilot mcp"
3. Click "Edit in settings.json"
4. Add the configuration below
5. Restart VS Code

Option 2: Direct Edit

Add to .vscode/settings.json or ~/.config/Code/User/settings.json:

{
  "github.copilot.mcp.servers": {
    "soulcraft-memory": {
      "command": "npx",
      "args": ["-y", "@soulcraft/mcp-server"],
      "env": {
        "SOULCRAFT_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

🔧 Continue.dev

Config file location: .continue/mcpServers/soulcraft.yaml

Configuration:

name: Soulcraft Memory
command: npx
args:
  - "-y"
  - "@soulcraft/mcp-server"
env:
  SOULCRAFT_API_KEY: YOUR_API_KEY_HERE

Restart Continue.dev extension after saving.

🛠️ Other MCP-Compatible Tools

For tools not listed above, use this universal HTTP configuration:

{
  "mcpServers": {
    "soulcraft-memory": {
      "transport": "http",
      "url": "https://memory.soulcraft.com/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Check your tool's documentation for the config file location (usually ~/.your-tool/mcp.json).

🔧 Troubleshooting

Connection Issues

• Make sure you completely restarted your AI tool (quit and reopen, not just refresh)
• Verify your API key is correct (copy-paste from dashboard)
• Check that the config file has valid JSON syntax (use a JSON validator)
• Wait 5-10 seconds after restart for connection to establish

Can't Find Config File

Use this command to locate your config file:

find ~ -name "mcp.json" 2>/dev/null

Tools Not Showing Up

• Ensure your AI tool supports MCP (Model Context Protocol)
• Check the tool's documentation for MCP setup instructions
• Verify the URL is correct: https://memory.soulcraft.com/mcp
• Make sure there are no extra spaces or quotes in the config

API Key Not Working

• Generate a new API key from the dashboard
• Make sure you're using the complete key (starts with "sm_")
• Check for extra spaces before or after the key in the config
• Verify the key is placed in the correct field (headers.X-API-Key for HTTP, env.SOULCRAFT_API_KEY for stdio)

Still Having Issues?

We're here to help! Contact support at support@soulcraft.com or check our GitHub repository for community support.

← Back to Dashboard