Note Sync for Openclaw

A note-taking skill that enables AI agents to append ideas, reminders, and journal entries to local Markdown files using a Model Context Protocol (MCP) tool.

lgwventrue
v1.0.1
Jun 11, 2026
0
511
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install note-sync

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install note-sync using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Note Sync?

Note Sync is an integration designed to bridge the gap between AI conversations and personal knowledge management. By utilizing a custom Model Context Protocol (MCP) server running locally, this skill empowers AI assistants to save chat messages, brainstormed ideas, and action items directly to local files. It is an essential component among Openclaw Skills for developers and power users who want to keep their insights organized on disk without leaving their AI workspace.

The skill operates via the append_note tool, allowing the assistant to safely interact with local storage on your host machine or within a Windows Subsystem for Linux (WSL) environment. It handles file writing, appends notes directly under designated headers, and categorizes information automatically based on user intent. This keeps your personal notes, journals, and task lists structured entirely in local Markdown format.

Note Sync Use Cases

  • Automatically capturing fleeting thoughts, insights, or code snippets during an AI chat session and storing them directly in a local journal.
  • Maintaining task backlogs or to-do lists by appending new items to a dedicated file.
  • Aggregating research notes or multi-step action plans generated during AI analysis directly to disk.
  • Organizing personal journals or daily logs locally in Markdown files without manual copy-pasting.

How Note Sync Works

  1. The user requests the AI agent to save or log information (e.g., 'Save this idea to my journal').
  2. The AI assistant triggers the append_note tool, automatically inferring the file name (such as 'journal' or 'todo') and structuring the Markdown content.
  3. The note-sync MCP server receives the command and appends the new text block securely to the specified local Markdown file.
  4. The server returns a success confirmation, updating the AI agent so it can notify the user that their note is stored safely in their workspace.

Note Sync Setup

Follow these steps to configure Note Sync, one of the most reliable productivity Openclaw Skills:

Step 1: Clone the Repository and Build the MCP Binary

Clone the helper repository to your machine (or within WSL) and compile the Go executable:

git clone https://github.com/your-org/go-note-sync-mcp.git
cd go-note-sync-mcp/mcp-server
go build -o note-sync-mcp.exe

Ensure that the environment variable NOTE_SYNC_REPO points directly to the root of this cloned directory.

Step 2: Configure openclaw.json

Edit your Openclaw configuration file (usually located at ~/.openclaw/openclaw.json) to register the skill and its local MCP server. Replace <WSL_REPO> with your local repository path, and <SKILL_DIR> with the location where ClawHub installed the skill (typically ~/.openclaw/skills/note-sync):

{
  "skills": {
    "entries": {
      "note-sync": {
        "enabled": true,
        "env": {
          "NOTE_SYNC_REPO": "<WSL_REPO>"
        }
      }
    }
  },
  "mcp": {
    "servers": {
      "note-sync": {
        "command": "<SKILL_DIR>/scripts/note-sync-mcp.sh",
        "args": []
      }
    }
  }
}

Step 3: Restart Gateway and Verify

Restart the gateway process and check that the skill and tool are loaded correctly:

openclaw gateway restart
openclaw skills info note-sync
openclaw mcp list

Upon success, the append_note tool should be displayed in the terminal list.

Note Sync Data Schema & Taxonomy

The Note Sync skill manages data dynamically on your local filesystem under the <repo>/mcp-server/notes/ directory. Each note is saved as a discrete Markdown (.md) file using the inferred title as the filename.

Directory Layout

<NOTE_SYNC_REPO>/
└── mcp-server/
    ├── notes/
    │   ├── 感悟.md
    │   ├── 待办.md
    │   └── journal.md
    └── note-sync-mcp.exe

MCP Tool Parameter Schema

The primary tool interface append_note expects the following payload structured as JSON:

Argument Type Required Description
title string Yes The filename and title of the note (e.g., 'journal', 'todo')
content string Yes The Markdown-compatible body content to append to the file

Note Sync Advanced Features

  • WSL & Windows Native Interoperability: Designed to run seamlessly across environments using shell wrappers that cross the WSL boundary to launch Windows .exe files.
  • Custom Directory Overrides: Easily adjust path configurations to point your note storage directly into Obsidian vault directories or Logseq graphs.
  • Dynamic Title Inference: Uses LLM-driven intelligence to analyze conversational context and automatically categorize notes under appropriate files without user prompting.
  • Model Context Protocol Integration: Leverage robust MCP tooling standards, ensuring high compatibility with other Openclaw Skills and modern agent interfaces.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Requires
Github Stars: 0
forks: 0

Featured*