MemmyReference
Desktop Local API
The desktop local API is built on Fastify and binds to a random port on 127.0.0.1. Everything except /api/health is authenticated with x-memmy-local-token; due to EventSource limitations, SSE passes the same token via ?token=.
Main Endpoint Groups
| Group | Representative Endpoints |
|---|---|
| App configuration | PATCH /api/app/settings, GET/PUT /api/app/model-config, POST /api/app/model-config/test |
| Account | POST /api/account/send-code, POST /api/account/verify-code, POST /api/account/logout |
| Integrations & channels | GET /api/v1/integrations/capabilities, POST /api/v1/channels/:provider/connect |
| Agent Source | GET /api/agent-sources, POST /api/agent-sources/scan, POST /api/agent-sources/:sourceId/skill |
| Local data | POST /api/local-data/reveal, POST /api/local-data/export, DELETE /api/local-data |
| Memory proxy | /api/v1/memory/*, /api/v1/panel/* (proxied to the Memory Runtime) |
| MCP bridge | GET/POST/DELETE /mcp/composio (separate x-memmy-mcp-token) |
SSE Events
/api/events pushes: app.connected, app.heartbeat, agent_source.scan_progress, agent_source.scan_completed.