A Home Assistant add-on that provides an AI memory service using the Model Context Protocol (MCP). This allows AI agents to store and retrieve persistent memories through a simple HTTP API.

The MCP Memory Service enables AI agents to maintain context and memory across conversations and sessions. It's perfect for:

• 🤖 AI Assistants - Remember user preferences and past interactions
• 💬 Chatbots - Maintain conversation context over time
• 🔄 Automation - Store and recall state information
• 📚 Knowledge Base - Build a searchable memory database

• ✅ RESTful HTTP API for easy integration
• 🔐 Optional API key authentication
• 🌐 CORS support for web applications
• 💾 Persistent storage in Home Assistant
• 🏗️ Multi-architecture support (ARM, x64, etc.)
• 📊 Health monitoring and logging
• 🔍 Search and filtering capabilities

1. Add this repository to Home Assistant:

   • Supervisor → Add-on Store → ⋮ → Repositories
   • Add: https://github.com/swingerman/ha-mcp-memory-addon

2. Install the MCP Memory Service add-on

3. Configure and start the add-on

See Installation Guide for detailed instructions.

1. Install and start the add-on
2. Test the service:

   curl http://homeassistant:8080/health

3. Store a memory:

   curl -X POST http://homeassistant:8080/memory/store \
     -H "Content-Type: application/json" \
     -d '{"content": "User prefers morning meetings"}'

4. Search memories:

   curl "http://homeassistant:8080/memory/search?query=meeting"

log_level: info
storage_path: "/data"
cors_enabled: true
api_key: ""  # Optional authentication

See API Documentation for complete endpoint reference.

Access your memory service from anywhere:

• Port Forwarding: Forward port 8080 to your HA instance
• Reverse Proxy: Use Nginx Proxy Manager (recommended)
• VPN: Access through your Home Assistant VPN

1. Clone the repository:

   git clone https://github.com/swingerman/ha-mcp-memory-addon.git
   cd ha-mcp-memory-addon

2. Build and test locally (requires Home Assistant build environment):

   # Note: This requires the Home Assistant add-on build system
   # For local testing, install the add-on in Home Assistant

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Add tests if applicable
5. Submit a pull request

• 📖 Documentation: Installation | API Reference
• 🐛 Issues: GitHub Issues
• 💬 Discussions: GitHub Discussions

MIT License - see the LICENSE file for details.

• Based on the MCP Memory Service
• Built for the Model Context Protocol
• Home Assistant add-on framework

Home Assistant add-on for hosting MCP Memory Service with HTTP API