718f4c6900
All checks were successful
Deploy to Production / Build and Deploy (push) Successful in 1m35s
MCP Server: - Fix validateApiKey: O(1) direct lookup by shortId instead of loading all keys - Add trashedAt:null filter to ALL note queries (trashed notes leaked in results) - Compact JSON output (~40% smaller responses) - Bounded session cache (Map with MAX_SESSIONS=500) to prevent memory leaks - PostgreSQL connection pooling (connection_limit=10) - Rewrite all 22 tool descriptions in clear English - Fix /sse fallback to proper 307 redirect memento-note Performance: - loading=lazy on all note images - Split notebooksRefreshKey from global refreshKey (note CRUD no longer re-fetches notebooks) - Remove searchKey from trash count deps (no re-fetch on every keystroke) - Server-side notebookId filter in getAllNotes() (biggest win) - Skip collaborator fetch for non-shared notes (eliminates N+1 API calls) - next/dynamic for MarkdownContent + 4 modals (code-split remark/rehype/KaTeX) - Memoize DOMPurify sanitize with useMemo Security: - XSS: DOMPurify sanitize in note-card and note-history-modal - Auth anti-enumeration: uniform errors in auth.ts - CRON_SECRET mandatory on cron endpoints - Rate limiting on login (5 attempts/min per email) - Centralized API auth helpers (requireAuth/requireAdmin) - randomize-labels changed GET→POST - Removed debug endpoints (/api/debug/config, /api/debug/test-chat) Cleanup: - Removed dead code: .backup-keep, settings-backup, fix-*.js, debug-theme, fix-labels route - Removed sensitive console.error in auth.ts - Ollama fetchWithTimeout (30s/60s AbortController) - i18n: full Arabic translation, Farsi missing keys - Masonry drag-and-drop fix (localOrderMap, cross-section block) - Sidebar notebook tooltip on truncation
Memento MCP Server
Model Context Protocol (MCP) server for integrating Memento note-taking app with N8N, Claude Desktop, and other MCP clients.
Quick Start
cd mcp-server
npm install
stdio Mode (Claude Desktop, Cline)
node index.js
Claude Desktop configuration:
{
"mcpServers": {
"memento": {
"command": "docker",
"args": ["exec", "-i", "memento-mcp", "node", "index.js"]
}
}
}
HTTP Streamable Mode (N8N, remote)
node index-sse.js
Requires DATABASE_URL environment variable pointing to your PostgreSQL database.
For Docker deployment, MCP_MODE and MCP_REQUIRE_AUTH are pre-configured in docker-compose.yml.
Authentication
When MCP_REQUIRE_AUTH=true (default in Docker), all requests require an x-api-key header.
Generate API keys from the Memento web UI: Settings > MCP.
# Example: health check with API key
curl -H "x-api-key: mcp_sk_xxx" http://localhost:3001/
Available Tools (22)
Notes (11)
| Tool | Description |
|---|---|
create_note |
Create a new note |
get_notes |
List notes (filterable) |
get_note |
Get a specific note by ID |
update_note |
Update an existing note |
delete_note |
Delete a note |
search_notes |
Search notes by keyword |
move_note |
Move a note to a notebook |
toggle_pin |
Pin/unpin a note |
toggle_archive |
Archive/unarchive a note |
export_notes |
Export notes as JSON |
import_notes |
Import notes from JSON |
Notebooks (6)
| Tool | Description |
|---|---|
create_notebook |
Create a notebook |
get_notebooks |
List all notebooks |
get_notebook |
Get notebook details |
update_notebook |
Update a notebook |
delete_notebook |
Delete a notebook |
reorder_notebooks |
Reorder notebooks |
Labels (4)
| Tool | Description |
|---|---|
create_label |
Create a label |
get_labels |
List labels |
update_label |
Update a label |
delete_label |
Delete a label |
Reminders (1)
| Tool | Description |
|---|---|
get_due_reminders |
Get due reminders |
N8N Integration
MCP Client Node Configuration
- Add a MCP Client node in N8N
- Select Streamable HTTP as transport
- Endpoint:
http://memento-mcp:3001/mcp(Docker) orhttp://YOUR_IP:3001/mcp - Add Header Auth:
x-api-key= your MCP API key
Example Workflow: Create a note from email
{
"tool": "create_note",
"arguments": {
"title": "{{ $json.subject }}",
"content": "{{ $json.body }}",
"labels": ["email", "inbox"]
}
}
HTTP Endpoints
| Endpoint | Method | Description |
|---|---|---|
/ |
GET | Health check |
/mcp |
GET/POST | Main MCP endpoint (Streamable HTTP) |
/sse |
GET/POST | Legacy redirect to /mcp |
/sessions |
GET | Active sessions |
Configuration
| Variable | Default | Description |
|---|---|---|
PORT |
3001 | Server port |
DATABASE_URL |
required | PostgreSQL connection string |
MCP_MODE |
stdio | Transport mode (stdio or sse) |
MCP_REQUIRE_AUTH |
false | Require x-api-key header |
MCP_LOG_LEVEL |
info | Log level (debug, info, warn, error) |
MCP_REQUEST_TIMEOUT |
30000 | Request timeout in ms |
APP_BASE_URL |
http://localhost:3000 | Memento app URL |
License
MIT