feat(mcp): add all 4 note types, translate N8N docs to English, add N8N workflow examples
All checks were successful
Deploy to Production / Build and Deploy (push) Successful in 55s
All checks were successful
Deploy to Production / Build and Deploy (push) Successful in 55s
- tools.js: expose type enum ['text','markdown','richtext','checklist'] in create_note & update_note - default changed from 'text' to 'richtext' (matches Prisma schema) - isMarkdown marked as deprecated in favour of type='markdown' - N8N-CONFIG.md: full French → English translation - N8N-WORKFLOWS.md: full French → English translation - N8N-EXAMPLES.md: new comprehensive examples for all 22 MCP tools + workflow patterns - n8n-workflow-mcp-reminder-bot.json: cron → get_due_reminders → Telegram → mark done - n8n-workflow-mcp-email-to-note.json: IMAP → create_note → urgent Slack alert - n8n-workflow-mcp-daily-digest.json: 8AM cron → notes + reminders digest → save + Slack - n8n-workflow-mcp-webhook-to-note.json: universal webhook → create_note → respond - notebooks-list.tsx: fix truncated notebook names (pe-24→pe-14), replace hover overlay with Tooltip
This commit is contained in:
Antigravity
571
mcp-server/N8N-EXAMPLES.md
Normal file
571
mcp-server/N8N-EXAMPLES.md
Normal file
@@ -0,0 +1,571 @@
|
||||
# N8N Examples — Memento MCP Server
|
||||
|
||||
Practical, copy-paste-ready N8N workflow snippets for every Memento MCP tool.
|
||||
All examples assume an MCP Client node configured with Streamable HTTP and `x-api-key` authentication.
|
||||
|
||||
## Note Types
|
||||
|
||||
| `type` value | Description |
|
||||
|--------------|-------------|
|
||||
| `richtext` | Rich text editor — **default** |
|
||||
| `markdown` | Markdown rendered (preferred over deprecated `isMarkdown`) |
|
||||
| `text` | Plain text |
|
||||
| `checklist` | Interactive checklist with `checkItems` |
|
||||
|
||||
> **Note**: `isMarkdown: true` is deprecated. Use `"type": "markdown"` instead.
|
||||
|
||||
---
|
||||
|
||||
|
||||
## Notes
|
||||
|
||||
### Create a simple text note
|
||||
|
||||
```json
|
||||
{
|
||||
"tool": "create_note",
|
||||
"arguments": {
|
||||
"title": "Quick idea",
|
||||
"content": "Explore serverless architecture for the new API gateway.",
|
||||
"color": "yellow",
|
||||
"labels": ["idea", "architecture"]
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Create a pinned markdown note
|
||||
|
||||
```json
|
||||
{
|
||||
"tool": "create_note",
|
||||
"arguments": {
|
||||
"title": "Project README",
|
||||
"content": "# My Project\n\nThis is the main documentation.\n\n## Getting Started\n\n```bash\nnpm install\nnpm run dev\n```",
|
||||
"isMarkdown": true,
|
||||
"isPinned": true,
|
||||
"color": "blue",
|
||||
"size": "large"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Create a checklist note
|
||||
|
||||
```json
|
||||
{
|
||||
"tool": "create_note",
|
||||
"arguments": {
|
||||
"title": "Weekly tasks",
|
||||
"content": "Tasks for this week",
|
||||
"type": "checklist",
|
||||
"checkItems": [
|
||||
{ "id": "1", "text": "Review pull requests", "checked": false },
|
||||
{ "id": "2", "text": "Update deployment docs", "checked": false },
|
||||
{ "id": "3", "text": "Team standup notes", "checked": true }
|
||||
],
|
||||
"color": "teal"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Create a note with a reminder
|
||||
|
||||
```json
|
||||
{
|
||||
"tool": "create_note",
|
||||
"arguments": {
|
||||
"title": "Dentist appointment",
|
||||
"content": "Dr. Martin — 10:30 AM. Bring insurance card.",
|
||||
"reminder": "2025-06-15T10:00:00.000Z",
|
||||
"reminderRecurrence": "yearly",
|
||||
"color": "red",
|
||||
"labels": ["health", "personal"]
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Create a note in a specific notebook
|
||||
|
||||
```json
|
||||
{
|
||||
"tool": "create_note",
|
||||
"arguments": {
|
||||
"title": "Sprint planning notes",
|
||||
"content": "**Goal**: Ship user authentication by Friday.\n\n- Design review at 2PM\n- Backend API ready by Wednesday",
|
||||
"isMarkdown": true,
|
||||
"notebookId": "{{ $json.notebookId }}",
|
||||
"labels": ["sprint", "planning"],
|
||||
"color": "purple"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Create a note with external links
|
||||
|
||||
```json
|
||||
{
|
||||
"tool": "create_note",
|
||||
"arguments": {
|
||||
"title": "Research resources",
|
||||
"content": "Curated links for the ML paper review.",
|
||||
"links": [
|
||||
"https://arxiv.org/abs/2304.15004",
|
||||
"https://huggingface.co/papers",
|
||||
"https://paperswithcode.com"
|
||||
],
|
||||
"labels": ["research", "ml"],
|
||||
"color": "green"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Get all notes (lightweight)
|
||||
|
||||
```json
|
||||
{
|
||||
"tool": "get_notes",
|
||||
"arguments": {
|
||||
"limit": 50
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Get notes from a specific notebook
|
||||
|
||||
```json
|
||||
{
|
||||
"tool": "get_notes",
|
||||
"arguments": {
|
||||
"notebookId": "{{ $json.notebookId }}",
|
||||
"limit": 100
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Get unfiled notes (Inbox)
|
||||
|
||||
```json
|
||||
{
|
||||
"tool": "get_notes",
|
||||
"arguments": {
|
||||
"notebookId": "inbox",
|
||||
"limit": 50
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Get all notes including archived
|
||||
|
||||
```json
|
||||
{
|
||||
"tool": "get_notes",
|
||||
"arguments": {
|
||||
"includeArchived": true,
|
||||
"limit": 200,
|
||||
"fullDetails": true
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Get a single note by ID
|
||||
|
||||
```json
|
||||
{
|
||||
"tool": "get_note",
|
||||
"arguments": {
|
||||
"id": "{{ $json.noteId }}"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Search notes by keyword
|
||||
|
||||
```json
|
||||
{
|
||||
"tool": "search_notes",
|
||||
"arguments": {
|
||||
"query": "deployment kubernetes"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Search in a specific notebook
|
||||
|
||||
```json
|
||||
{
|
||||
"tool": "search_notes",
|
||||
"arguments": {
|
||||
"query": "{{ $json.searchTerm }}",
|
||||
"notebookId": "{{ $json.notebookId }}",
|
||||
"includeArchived": false
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Update a note's content
|
||||
|
||||
```json
|
||||
{
|
||||
"tool": "update_note",
|
||||
"arguments": {
|
||||
"id": "{{ $json.noteId }}",
|
||||
"content": "{{ $json.newContent }}",
|
||||
"color": "green"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Mark a checklist item as done
|
||||
|
||||
```json
|
||||
{
|
||||
"tool": "update_note",
|
||||
"arguments": {
|
||||
"id": "{{ $json.noteId }}",
|
||||
"checkItems": [
|
||||
{ "id": "1", "text": "Review pull requests", "checked": true },
|
||||
{ "id": "2", "text": "Update deployment docs", "checked": false }
|
||||
]
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Add labels to an existing note
|
||||
|
||||
```json
|
||||
{
|
||||
"tool": "update_note",
|
||||
"arguments": {
|
||||
"id": "{{ $json.noteId }}",
|
||||
"labels": ["ai-generated", "reviewed", "{{ $json.category }}"]
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Mark a reminder as done
|
||||
|
||||
```json
|
||||
{
|
||||
"tool": "update_note",
|
||||
"arguments": {
|
||||
"id": "{{ $json.noteId }}",
|
||||
"isReminderDone": true
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Move a note to a notebook
|
||||
|
||||
```json
|
||||
{
|
||||
"tool": "move_note",
|
||||
"arguments": {
|
||||
"id": "{{ $json.noteId }}",
|
||||
"notebookId": "{{ $json.targetNotebookId }}"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Move a note to Inbox (no notebook)
|
||||
|
||||
```json
|
||||
{
|
||||
"tool": "move_note",
|
||||
"arguments": {
|
||||
"id": "{{ $json.noteId }}",
|
||||
"notebookId": null
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Pin a note
|
||||
|
||||
```json
|
||||
{
|
||||
"tool": "toggle_pin",
|
||||
"arguments": {
|
||||
"id": "{{ $json.noteId }}"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Archive a note
|
||||
|
||||
```json
|
||||
{
|
||||
"tool": "toggle_archive",
|
||||
"arguments": {
|
||||
"id": "{{ $json.noteId }}"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Delete a note permanently
|
||||
|
||||
```json
|
||||
{
|
||||
"tool": "delete_note",
|
||||
"arguments": {
|
||||
"id": "{{ $json.noteId }}"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Export all notes as JSON backup
|
||||
|
||||
```json
|
||||
{
|
||||
"tool": "export_notes",
|
||||
"arguments": {}
|
||||
}
|
||||
```
|
||||
|
||||
### Import notes from a JSON backup
|
||||
|
||||
```json
|
||||
{
|
||||
"tool": "import_notes",
|
||||
"arguments": {
|
||||
"data": "{{ $json.exportPayload }}"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Notebooks
|
||||
|
||||
### Create a notebook
|
||||
|
||||
```json
|
||||
{
|
||||
"tool": "create_notebook",
|
||||
"arguments": {
|
||||
"name": "Work Projects",
|
||||
"icon": "💼",
|
||||
"color": "#3B82F6"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Create a notebook for a team/topic
|
||||
|
||||
```json
|
||||
{
|
||||
"tool": "create_notebook",
|
||||
"arguments": {
|
||||
"name": "Machine Learning Research",
|
||||
"icon": "🤖",
|
||||
"color": "#8B5CF6"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### List all notebooks
|
||||
|
||||
```json
|
||||
{
|
||||
"tool": "get_notebooks",
|
||||
"arguments": {}
|
||||
}
|
||||
```
|
||||
|
||||
### Get a notebook with its notes
|
||||
|
||||
```json
|
||||
{
|
||||
"tool": "get_notebook",
|
||||
"arguments": {
|
||||
"id": "{{ $json.notebookId }}"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Rename a notebook
|
||||
|
||||
```json
|
||||
{
|
||||
"tool": "update_notebook",
|
||||
"arguments": {
|
||||
"id": "{{ $json.notebookId }}",
|
||||
"name": "Q3 2025 Projects",
|
||||
"color": "#10B981"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Reorder notebooks
|
||||
|
||||
```json
|
||||
{
|
||||
"tool": "reorder_notebooks",
|
||||
"arguments": {
|
||||
"notebookIds": [
|
||||
"{{ $json.ids[0] }}",
|
||||
"{{ $json.ids[1] }}",
|
||||
"{{ $json.ids[2] }}"
|
||||
]
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Delete a notebook (notes go to Inbox)
|
||||
|
||||
```json
|
||||
{
|
||||
"tool": "delete_notebook",
|
||||
"arguments": {
|
||||
"id": "{{ $json.notebookId }}"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Labels
|
||||
|
||||
### Create a label inside a notebook
|
||||
|
||||
```json
|
||||
{
|
||||
"tool": "create_label",
|
||||
"arguments": {
|
||||
"name": "urgent",
|
||||
"color": "red",
|
||||
"notebookId": "{{ $json.notebookId }}"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Create common project labels
|
||||
|
||||
```json
|
||||
{
|
||||
"tool": "create_label",
|
||||
"arguments": {
|
||||
"name": "in-progress",
|
||||
"color": "orange",
|
||||
"notebookId": "{{ $json.notebookId }}"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
```json
|
||||
{
|
||||
"tool": "create_label",
|
||||
"arguments": {
|
||||
"name": "done",
|
||||
"color": "green",
|
||||
"notebookId": "{{ $json.notebookId }}"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### List labels in a notebook
|
||||
|
||||
```json
|
||||
{
|
||||
"tool": "get_labels",
|
||||
"arguments": {
|
||||
"notebookId": "{{ $json.notebookId }}"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### List all labels (global)
|
||||
|
||||
```json
|
||||
{
|
||||
"tool": "get_labels",
|
||||
"arguments": {}
|
||||
}
|
||||
```
|
||||
|
||||
### Rename a label
|
||||
|
||||
```json
|
||||
{
|
||||
"tool": "update_label",
|
||||
"arguments": {
|
||||
"id": "{{ $json.labelId }}",
|
||||
"name": "high-priority",
|
||||
"color": "red"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
### Delete a label
|
||||
|
||||
```json
|
||||
{
|
||||
"tool": "delete_label",
|
||||
"arguments": {
|
||||
"id": "{{ $json.labelId }}"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Reminders
|
||||
|
||||
### Get all due reminders (for cron automation)
|
||||
|
||||
```json
|
||||
{
|
||||
"tool": "get_due_reminders",
|
||||
"arguments": {}
|
||||
}
|
||||
```
|
||||
|
||||
> **Tip**: Schedule this every 30 minutes with a cron trigger (`0 */30 * * * *`), then loop over results and send notifications via Slack, Telegram, or email.
|
||||
|
||||
---
|
||||
|
||||
## Common Workflow Patterns
|
||||
|
||||
### Pattern: Email → Note
|
||||
1. **Email Trigger (IMAP)** — fires on new email
|
||||
2. **MCP Client** → `create_note`
|
||||
```json
|
||||
{
|
||||
"title": "{{ $json.subject }}",
|
||||
"content": "**From**: {{ $json.from }}\n\n{{ $json.text }}",
|
||||
"labels": ["email"],
|
||||
"color": "blue",
|
||||
"isMarkdown": true
|
||||
}
|
||||
```
|
||||
|
||||
### Pattern: Reminder Notifications
|
||||
1. **Schedule Trigger** — every 30 minutes
|
||||
2. **MCP Client** → `get_due_reminders`
|
||||
3. **IF** — results not empty
|
||||
4. **Loop over items** → send Slack/Telegram message per reminder
|
||||
5. **MCP Client** → `update_note` with `isReminderDone: true`
|
||||
|
||||
### Pattern: AI Summarization
|
||||
1. **MCP Client** → `search_notes` with a topic query
|
||||
2. **OpenAI / Anthropic node** — summarize the returned notes
|
||||
3. **MCP Client** → `create_note` with the summary as content, labeled `ai-summary`
|
||||
|
||||
### Pattern: Daily Digest
|
||||
1. **Schedule Trigger** — every day at 8 AM
|
||||
2. **MCP Client** → `get_notes` with `limit: 20` (most recent)
|
||||
3. **AI node** — generate a brief digest
|
||||
4. **Email / Slack node** — send the digest
|
||||
5. *(Optional)* **MCP Client** → `create_note` to archive the digest
|
||||
|
||||
### Pattern: Webhook → Structured Note
|
||||
1. **Webhook Trigger** — receives JSON payload (e.g., from a form or CI/CD pipeline)
|
||||
2. **Code node** — format the payload into markdown
|
||||
3. **MCP Client** → `create_note`
|
||||
```json
|
||||
{
|
||||
"title": "Build #{{ $json.buildNumber }} — {{ $json.status }}",
|
||||
"content": "{{ $node['Code'].json.markdown }}",
|
||||
"isMarkdown": true,
|
||||
"color": "{{ $json.status === 'success' ? 'green' : 'red' }}",
|
||||
"labels": ["ci-cd", "{{ $json.repo }}"]
|
||||
}
|
||||
```
|
||||
Reference in New Issue
Block a user