n8n-nodes-valora


Custom n8n nodes for Valora AI Memory Platform - Seamlessly integrate AI memory management and cross-platform chat export into your automation workflows.

🚀 Features

- Memory Management: Create, read, update, delete memories with full metadata support
- Chat Import: Import conversations from any AI platform (Claude, ChatGPT, etc.)
- Cross-Platform Export: Export conversations to 6+ AI platform formats
- Webhook Triggers: React to memory changes in real-time
- Semantic Search: Find memories using natural language queries
- Enterprise Ready: Production-grade error handling and logging

📦 Installation

$3

``bash
npm install n8n-nodes-valora
`

$3

1. Clone this repository
2. Run npm install
3. Run npm run build
4. Copy the dist folder to your n8n custom nodes directory

$3

`bash
npm install https://github.com/yorbuachi72/valora-memory-server.git#n8n-nodes-valora
`

⚙️ Setup

$3

In your n8n instance, go to Settings > Community Nodes and add:
`
n8n-nodes-valora
`

$3

Create a new credential of type "Valora API":

- Server URL: http://localhost:3000 (or your Valora instance URL)
- API Key: Your Valora API key

$3

Use the Test button in credentials to ensure your Valora instance is accessible.

🎯 Available Nodes

$3

The main node for all Valora operations.

#### Memory Operations
- Create: Store new memories with tags and metadata
- Get: Retrieve specific memories by ID
- Search: Semantic search through all memories
- Update: Modify existing memories
- Delete: Remove memories

#### Chat Operations
- Import: Import chat conversations from JSON

#### Export Operations
- Conversation: Export conversations to AI platforms
- Formats: List available export formats

$3

Triggers workflows when Valora events occur.

#### Supported Events
- memory.created - New memory added
- memory.updated - Memory modified
- memory.deleted - Memory removed
- chat.imported - Chat conversation imported
- search.performed - Memory search executed
- export.completed - Export operation finished

📋 Workflow Examples

$3

Scenario: Transfer a Claude conversation to ChatGPT

`
[Manual Trigger] → [Valora: Import Chat] → [Valora: Export to OpenAI] → [HTTP Request: Send to ChatGPT]
`

Configuration:
- Import Chat: Set source to "claude", paste conversation JSON
- Export: Choose "openai" format
- HTTP Request: POST to ChatGPT API with exported messages

$3

Scenario: Slack notifications for important memories

`
[Valora Trigger: memory.created] → [Filter: tag=important] → [Slack: Send Message]
`

Configuration:
- Valora Trigger: Select "memory.created" event
- Filter: Check if memory tags contain "important"
- Slack: Send formatted message with memory content

$3

Scenario: Web scraping → AI summarization → Memory storage

`
[HTTP Request: Scrape URL] → [OpenAI: Summarize] → [Valora: Create Memory]
`

Configuration:
- HTTP Request: Scrape target website
- OpenAI: Prompt to summarize content
- Valora: Store summary as memory with research tags

$3

Scenario: Daily backup of all memories to Google Drive

`
[Cron: Daily] → [Valora: Search *] → [Google Drive: Upload JSON]
`

Configuration:
- Cron: Schedule for daily execution
- Valora: Search with "*" query, limit 1000
- Google Drive: Upload formatted JSON backup

🔧 Node Reference

$3

#### Common Parameters
- Resource: memory, chat, or export
- Operation: Action within the selected resource

#### Memory Create/Update
`
Content: The memory text content
Source: Origin (e.g., "n8n", "manual")
Tags: Comma-separated tags
`

#### Memory Search
`
Query: Search terms or natural language
Limit: Maximum results (1-100)
Tags: Filter by specific tags
`

#### Chat Import
`
Messages: JSON array of chat messages
Source: Platform (claude, chatgpt, etc.)
Conversation ID: Optional unique identifier
`

#### Export Conversation
`
Conversation ID: ID from imported chat
Target Platform: openai, claude, gemini, mistral, llama, universal
`

$3

#### Event Selection
- Choose which events trigger the workflow
- Multiple events can be selected

#### Response Data
- All: Complete webhook payload
- Data Only: Just the event data

🔗 Integration Examples

$3


`json
{
"nodes": [
{
"type": "n8n-nodes-valora.valoraTrigger",
"parameters": {
"events": ["memory.created"],
"responseData": "all"
}
},
{
"type": "@n8n/nodes-base.slack",
"parameters": {
"text": "New memory: {{ $json.data.content.substring(0, 100) }}..."
}
}
]
}
`

$3

`json
{
"nodes": [
{
"type": "n8n-nodes-valora.valora",
"parameters": {
"resource": "memory",
"operation": "create",
"content": "API response data",
"tags": "api,response"
}
}
]
}
`

🛠️ Development

$3

- Node.js 16+
- npm or yarn
- n8n instance for testing

$3

`bash

Clone and setup

git clone https://github.com/yorbuachi72/valora-memory-server.git
cd valora-memory-server/n8n-nodes-valora

Install dependencies

npm install

Build

npm run build

Test

npm test
`

$3

1. Add node logic in nodes/YourNode/YourNode.node.ts`
2. Update package.json node declarations
3. Add credentials if needed
4. Update documentation

📊 API Compatibility

| Valora Version | n8n-nodes-valora | Status |
|----------------|------------------|--------|
| v2.0.0+ | v1.0.0+ | ✅ Compatible |

🤝 Contributing

1. Fork the repository
2. Create a feature branch
3. Add tests for new functionality
4. Ensure all tests pass
5. Submit a pull request

📝 License

MIT License - see LICENSE file for details.

🆘 Support

- Documentation: Valora Docs
- Issues: GitHub Issues
- Discussions: GitHub Discussions

🎯 Roadmap

- [ ] OAuth authentication support
- [ ] Bulk operations for multiple memories
- [ ] Advanced filtering and search options
- [ ] Memory templates and presets
- [ ] Integration with popular AI platforms
- [ ] Visual memory relationship mapping

---

Built with ❤️ for the AI automation community

Transform your AI conversations into actionable, searchable, and transferable knowledge with Valora + n8n!