Search the owner's messages by meaning and by keyword, best match first.

Every filter narrows the search before it ranks anything, so a filtered search finds the best matches within those messages. If results is empty or note is set, note says why and what to try.

The messages around one message, in its chat, oldest first; it has hit: true.

Use it when a search result is relevant but needs what was said around it: the question it answers, the reply, what "it" refers to.

Add a manual memory/note to your personal memory store.

Args: content: The text content to remember source: Source label for this memory (default: 'manual') metadata: Optional key-value metadata to attach

Who is in the archive: the most-messaged people with their chats, the busiest group chats, and the platforms.

Not needed before searching: search_memoreei finds people by name or number itself.

Refresh memory from the sources configured on the server.

Runs every connector set up in the server's config, and re-reads any import files that were registered on the server and have changed since. Takes no arguments: it can only refresh what the server's owner has already set up.

Trigger an immediate sync of all configured sources and return new message count.

Sync every configured connector and return counts per source.

Iterates over all connectors that have sufficient configuration (Discord, Telegram, Matrix, Slack, email, Mastodon) and syncs each one.

Sync recent Discord messages from the configured channel.

Args: channel_id: Discord channel ID to sync (uses DISCORD_CHANNEL_ID env var if not provided)

Sync new Telegram messages received by the bot into memory.

Uses the Telegram Bot API (getUpdates) to fetch messages sent to the bot since the last sync. Requires TELEGRAM_BOT_TOKEN in environment.

Args: chat_id: Telegram chat ID to filter (positive = user DM, negative = group). Syncs all chats if not provided. Uses TELEGRAM_CHAT_ID env var as default.

Sync Matrix room messages into memory using the Matrix Client-Server API.

Fetches messages from a Matrix room and stores them for search. Uses a per-room pagination token checkpoint to avoid re-ingesting messages.

Requires environment variables: MATRIX_HOMESERVER - e.g. https://matrix.org MATRIX_ACCESS_TOKEN - user access token MATRIX_ROOM_ID - default room to sync (optional if room_id provided)

Args: room_id: Matrix room ID to sync (e.g. !abc123:matrix.org). Uses MATRIX_ROOM_ID env var if not provided.

Sync recent Slack messages from the configured channel into memory.

Uses the Slack Web API (conversations.history) to fetch messages since the last sync. Requires a bot token with channels:history and users:read scopes.

Requires environment variables: SLACK_BOT_TOKEN - Slack bot token (xoxb-...) SLACK_CHANNEL_ID - default channel to sync (optional if channel_id provided)

Args: channel_id: Slack channel ID to sync (e.g. C1234567890). Uses SLACK_CHANNEL_ID env var if not provided.

Sync Gmail messages into memory via IMAP.

Fetches emails from a Gmail folder and stores them for search. Uses a per-folder UID checkpoint to avoid re-ingesting messages on subsequent syncs.

Requires environment variables: GMAIL_EMAIL - Gmail address (e.g. you@gmail.com) GMAIL_APP_PASSWORD - Gmail App Password (required if 2FA is enabled). Create one at https://myaccount.google.com/apppasswords GMAIL_PASSWORD may be used instead for non-2FA accounts, but Google has deprecated plain-password IMAP access.

Args: folder: IMAP folder to sync (default: 'INBOX'). Other options: '[Gmail]/Sent Mail', '[Gmail]/All Mail', etc. max_emails: Maximum number of emails to ingest per sync (default: 200).

Sync recent Mastodon posts from a public or hashtag timeline into memory.

Uses the Mastodon REST API. Public and hashtag timelines require no authentication. An access token is only needed for home timeline or private accounts.

Optional environment variables: MASTODON_INSTANCE - Mastodon instance URL (default: https://mastodon.social) MASTODON_HASHTAG - default hashtag to sync (without #) MASTODON_ACCESS_TOKEN - access token for authenticated requests (optional)

Args: instance: Mastodon instance base URL (e.g. https://fosstodon.org). Uses MASTODON_INSTANCE env var if not provided. hashtag: Hashtag to sync (without #, e.g. 'python'). Uses MASTODON_HASHTAG env var or public timeline if not provided. access_token: OAuth access token. Uses MASTODON_ACCESS_TOKEN env var if not provided.

Sync iMessage/SMS conversations from the local macOS Messages database.

Reads ~/Library/Messages/chat.db in read-only mode. macOS only — returns an error dict on other platforms without raising.

Requires Full Disk Access for the program running this server, granted in System Settings → Privacy & Security → Full Disk Access (memoreei service grant-access opens it with the right file shown).

The path to chat.db can be overridden with the IMESSAGE_DB_PATH env var.

Args: chat_name: Optional filter — only sync messages from this chat/contact. Matches against chat_identifier (e.g. '+1234567890') or display name.

Sync WhatsApp chats from WhatsApp for Mac's database on this machine.

Reads ChatStorage.sqlite read-only: WhatsApp for Mac's, or the file WHATSAPP_DB_PATH names, such as the one in an iPhone backup. Texts, captions, shared links and document names are kept; stickers, voice notes and reactions have no words to keep.

Sync Signal from Signal Desktop's database on this computer.

Needs Signal connected first (the dashboard's Sources page, or memoreei setup signal), which reads Signal's database key from the system keyring once. Texts, captions, links, group changes and calls are kept, reactions and edits follow the message they belong to, and disappearing messages are never stored.

Import SMS/MMS messages from an Android SMS Backup & Restore XML file. Works with the 'SMS Backup & Restore' app (most popular on Google Play).

Args: file_path: Path to the XML backup file

Import a Discord Data Package (GDPR export). Imports all messages from all channels and DMs.

Request your data at Discord Settings > Privacy & Safety > Request All of My Data. Once downloaded, extract the ZIP or pass it directly — both are supported.

Args: package_path: Path to extracted data package folder or ZIP file

Import Facebook Messenger messages from a data download (GDPR export, JSON format). Download from: Facebook Settings > Your Information > Download Your Information. Args: data_path: Path to the extracted Messenger data folder (containing messages/inbox/)

Import messages from any JSON file. Provide field names for your data format.

Supports JSON arrays, JSON-lines format, and wrapped objects. Covers Google Chat takeout, Google Hangouts exports, LinkedIn data, and any custom JSON format.

Args: file_path: Path to the JSON or JSON-lines file content_field: Field name containing the message text (required) sender_field: Field name containing the sender name (optional) timestamp_field: Field name containing the timestamp (optional, auto-detects format) source_label: Label to tag imported messages with (default: 'json-import')

Import messages from any CSV file. Provide column names for your data format.

Auto-detects delimiter (comma, tab, semicolon). Supports header rows. Covers LinkedIn exports, any spreadsheet or custom CSV format.

Args: file_path: Path to the CSV, TSV, or delimited file content_column: Column name containing the message text (required) sender_column: Column name containing the sender name (optional) timestamp_column: Column name containing the timestamp (optional, auto-detects format) source_label: Label to tag imported messages with (default: 'csv-import')

Sync contacts from macOS AddressBook into the contacts table.

Maps phone numbers and email addresses to display names so that search results and source listings show contact names instead of raw identifiers. macOS only — returns an empty result on other platforms.

Import contacts from a vCard (.vcf) file.

Export from macOS Contacts: File → Export → Export vCard. Maps phone numbers and email addresses to display names.

Args: file_path: Path to the .vcf file

Import Instagram DMs from a data download (GDPR export, JSON format). Download at: Instagram Settings > Accounts Center > Your Information > Download Your Information. Args: data_path: Path to the extracted Instagram data folder (containing your_instagram_activity/)