Amplenote Openclaw

Name: Amplenote Openclaw
Rating: 3.5 (1 reviews)
Author: EthycalOne

By EthycalOne 👁 97 views ▲ 0 votes

OpenClaw plugin + skill connecting local LLMs to Amplenote via the amplenote-mcp bridge

GitHub

Configuration Example

{
  "plugins": {
    "amplenote": {
      "path": "/path/to/amplenote-openclaw",
      "config": {
        "bridgeUrl": "http://127.0.0.1:34737",
        "bridgeToken": "your-bridge-token-here",
        "amplenoteKey": "your-amplenote-api-key-here"
      }
    }
  }
}

README

# amplenote-openclaw

OpenClaw plugin that connects local (or frontier) LLMs to your [Amplenote](https://amplenote.com) second brain via the [amplenote-mcp](https://github.com/ethycalone/amplenote-mcp) bridge.

## Prerequisites

1. **[amplenote-mcp](https://github.com/ethycalone/amplenote-mcp)** — the bridge server and Amplenote plugin must be set up and synced first. Follow that project's README completely before continuing here.
2. **[OpenClaw](https://docs.openclaw.ai)** installed and configured.

## What this adds

- **18 tools** (`amplenote_*`) — read tools query the local bridge cache; write tools call the Amplenote REST API directly
- **A skill** (`skills/amplenote/SKILL.md`) that teaches the agent your PARA+GTD tag structure, conventions, and daily/weekly review workflows

## Installation

### 1. Clone this repo

```bash
git clone https://github.com/ethycalone/amplenote-openclaw
cd amplenote-openclaw
```

### 2. Register the plugin in OpenClaw

Add to your `openclaw.json`:

```json
{
  "plugins": {
    "amplenote": {
      "path": "/path/to/amplenote-openclaw",
      "config": {
        "bridgeUrl": "http://127.0.0.1:34737",
        "bridgeToken": "your-bridge-token-here",
        "amplenoteKey": "your-amplenote-api-key-here"
      }
    }
  }
}
```

`bridgeToken` must match `BRIDGE_TOKEN` in the `amplenote-mcp` `.env` file. Leave it empty if you didn't set a token.

### 3. Start the bridge

```bash
cd /path/to/amplenote-mcp
uv run amplenote-bridge
```

### 4. Sync your notes

In Amplenote, press **Ctrl+O → Sync to MCP**. Then start a session in OpenClaw — the agent will have access to your notes and tasks.

## Available tools

### Read (bridge cache)
| Tool | Description |
|---|---|
| `amplenote_sync_status` | Check bridge status and last sync time |
| `amplenote_list_tags` | Browse all tags with note counts |
| `amplenote_search_notes` | Full-text search across note names and content |
| `amplenote_search_tasks` | Full-text search across tasks |
| `amplenote_list_notes` | List notes, filter by tag or name |
| `amplenote_get_note_metadata` | Note metadata without content (fast) |
| `amplenote_get_note_content` | Full note content and tasks |
| `amplenote_list_tasks` | Query tasks by tag, due date, importance |
| `amplenote_list_deleted_notes` | List notes in trash |

### Write (Amplenote REST API — requires `amplenoteKey`)
| Tool | Description |
|---|---|
| `amplenote_create_note` | Create a new note with optional tags |
| `amplenote_append_note` | Prepend content to an existing note |
| `amplenote_rename_note` | Rename a note |
| `amplenote_move_note` | Change a note's tags (refile between PARA categories) |
| `amplenote_delete_note` | Soft-delete a note to trash |
| `amplenote_restore_note` | Restore a note from trash |
| `amplenote_create_task` | Add a task to a note |
| `amplenote_complete_task` | Mark a task complete |
| `amplenote_dismiss_task` | Dismiss a task without completing it |

## Skill

The `skills/amplenote` skill is automatically loaded and tells the agent:
- Your PARA tag structure and system tags
- Task context tags (`@next-action`, `@waiting-for`, etc.)
- How to use the tools effectively
- Daily review and weekly review workflows

integration