# MoonlyBox MoonLink

Wires your MoonlyBox knowledge workspace into an AI client, so bookmarks, sticky notes, todos and memory entries get saved straight from the chat.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: moonlybox
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/moonlybox/moonlink-mcp
- Updated: 2026-09-20
- HTML: https://affpapa.org/en/nevibecode/mcp/moonlybox-moonlink

## What it does

MoonLink is the official Model Context Protocol server for MoonlyBox, a hosted workspace for personal knowledge. The agent can file a bookmark, drop a sticky note, create a todo, save a note or memory entry, and pull a page archive — then search across all of it later with tools like `search_bookmarks`, `search_library` and `search_memory`. The server ships 24 tools in total, from `add_bookmark` through `restore_bookmark`.

Everything runs on the hosted endpoint `https://moonlybox.cn/mcp` over Streamable HTTP, so there is nothing to install locally. Access is gated: either OAuth with browser approval, or a personal access token sent as `Authorization: Bearer mk_...`. You issue the token in the 「AI 托管」 section after registering at `https://moonlybox.cn`. No token and no OAuth means the client will not connect.

The repository holds the integration spec and a behaviour template at `docs/agentsTemplate.md`, meant to be dropped in as `AGENTS.md` or `CLAUDE.md`. That template tells the agent when to write to memory silently and when to ask before deleting. Deletion is soft — bookmarks can be restored within 72 hours. The hosted service itself is proprietary; the docs and template are CC BY 4.0.

## Requirements
- Remote server: `https://moonlybox.cn/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http moonlybox-moonlink https://moonlybox.cn/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add moonlybox-moonlink --url https://moonlybox.cn/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "moonlybox-moonlink": {
            "url": "https://moonlybox.cn/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "moonlybox-moonlink": {
            "type": "http",
            "url": "https://moonlybox.cn/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http moonlybox-moonlink https://moonlybox.cn/mcp
```

## When to use it
- save a link as a bookmark without leaving the chat
- jot a thought down as a sticky note before it slips
- create a todo and later convert it into a sticky
- grab a page archive for offline reading
- search your own knowledge base for a note you half remember

## Example prompts
- Bookmark this article and tag it mcp
- Add a sticky note: check OAuth in Cherry Studio
- Search my library for anything about Streamable HTTP

## Similar
- [wiki-query](https://affpapa.org/en/nevibecode/skills/wiki-query.md) — skill · 3600 installs
- [ima-copilot](https://affpapa.org/en/nevibecode/skills/ima-copilot.md) — skill · 1600 installs
- [knowledge-base](https://affpapa.org/en/nevibecode/skills/knowledge-base.md) — skill · 835 installs
- [llm-wiki](https://affpapa.org/en/nevibecode/skills/hermes-agent-llm-wiki.md) — skill · 605 installs
- [wiki](https://affpapa.org/en/nevibecode/skills/agricidaniel-wiki.md) — skill · 539 installs
- [save](https://affpapa.org/en/nevibecode/skills/save.md) — skill · 511 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md