Integration Overview
Integration Overview
There are three ways to work with your Memoreru data from outside the app. This guide explains what each one offers and how to pick the right one for what you want to do.
| Method | How it works | Best for |
|---|---|---|
| API | Operate from your own programs | Connecting external apps, automating scheduled tasks |
| MCP Server | Operate through conversations with an AI assistant | Interactive reads and writes like "add a row to this table" |
| CLI | Sync local files with commands | Managing content as Markdown/CSV files |
All three use the same API key and are available on Light plans and above, including during the Feature Trial period.
Which One Should I Use?
| What you want to do | Recommended |
|---|---|
| Read and write Memoreru data from an external app or script | API |
| Automate a recurring data import | API |
| Read and write tables from AI tools like Claude Desktop | MCP Server |
| Search and create content while chatting with an AI | MCP Server |
| Publish local Markdown or CSV files to Memoreru as they are | CLI |
| Track content history with Git | CLI |
| Update many pages or tables in one batch | CLI |
API
Write your own programs to operate Memoreru. You can create, get, update, and delete content, and work with table rows and columns — almost every data operation Memoreru offers.
Use it when:
- You want to connect Memoreru with internal systems or other services
- You want to automate tasks, such as importing data at a fixed time every day
- You need fine-grained operations that MCP or the CLI doesn't cover
Both the MCP Server and the CLI are built on top of this API. The API is the foundation of everything and the most flexible option.
See "API Overview" and "API Examples" for details.
MCP Server
Connect Memoreru to AI tools like Claude Desktop or Cursor, and read and write data through conversation.
Use it when:
- You want to ask an AI to do things like "add these three books to my reading log table"
- You want an AI to read your table and help with summarizing or organizing
- You want to automate data operations without writing any code
Set up the connection once, and from then on you just talk to your AI in plain language. No files to prepare, no commands to type.
See "MCP Server Usage" for details.
CLI
A command-line tool that syncs Markdown, CSV, and JSON files on your computer with Memoreru.
Use it when:
- You want to write page drafts as Markdown files locally and publish them in one go
- You want to manage table data as CSV
- You want to keep content under Git version control
- You want a local copy of your Memoreru content
The big difference from the MCP Server is that the CLI works through files on your computer. You can review changes as a diff before publishing, and if several people are editing the same table, the CLI lets you know about conflicting edits when you push.
See "CLI Usage" for details.
Working with AI Assistants
Both the MCP Server and the CLI can be used from AI assistants. Here's how to choose:
| Situation | Recommended |
|---|---|
| You use an AI chat tool such as Claude Desktop | MCP Server |
| You use Claude Code and want it to edit content you manage as local files | CLI |
| You use Claude Code and want it to read and write table data directly | MCP Server |
As a rule of thumb: use the CLI for anything you want to manage as files, and the MCP Server for direct, on-the-spot data operations. Documents and writing you treat as file assets fit the CLI; tables you use like a database fit the MCP Server.
Common Setup: API Keys
Whichever method you choose, you first need an API key. You can generate one from the "API Keys" card under Settings > Security.
See "API Key Management" for how to generate keys and set access permissions.
Comments