Repository navigation
Releases
v0.4.2
LegendKeeper for Claude Desktop, covering chat and Cowork, which runs inside Desktop.
New since 0.3.0
100% API coverage
Every one of the 89 LegendKeeper v3 API operations, and every request field, is reachable through a tool. docs/API_COVERAGE.md shows the mapping, and a test fails the build if a gap opens.
- Sidebar order:
update_resourcereorders withafter/before, andlist_resourcesshows entries in sidebar order with their ranks. - Resources: icons, lock, banner, permissions, documents of any type at creation, and
create_resourcesfor up to 100 at once. - Block edits without rewriting the page:
read_block,insert_block,replace_block,update_block,move_block,delete_block,assign_block_ids. - Properties of every kind, in the sidebar or in an infobox on a page, plus single-row
set_row/delete_row. - Documents: every type, tab order, full width,
delete_document,restore_document. - Assets:
get_asset,create_asset_folder,update_asset. - Members and invites:
list_members,list_invites,invite_member(sends an email; the skill tells Claude to confirm with you first),remove_member,revoke_invite. - Smaller additions: template, lane, event and map-feature ids and placement; event date precision; multi-part regions; reading a single lane, event, feature or board page.
Icons that work
find_icon: searches a built-in directory of all 1,402 free Font Awesome 6 icons by idea ("king", "ship", "magic") or category. It makes no API call.- Icon names are cleaned up before they're sent:
fa-prefixes and capitals are dropped, and old Font Awesome 5 names are translated (home→house). - Rejected icons get a hint that points to
find_icon.
61 tools (18 read, 43 write) and 4 prompts.
Downloads
| File | What it is |
|---|---|
lk-mcp-darwin-arm64.mcpb |
Claude Desktop extension: the lk-mcp server for Apple Silicon Macs. |
legendkeeper-plugin.zip |
Skills plugin: legendkeeper-wiki and legendkeeper-worldbuilding. |
SHA256SUMS |
Checksums. Check them with shasum -a 256 -c SHA256SUMS. |
Install or upgrade
- Double-click
lk-mcp-darwin-arm64.mcpb. If an older version is installed, Claude Desktop replaces it and keeps your settings: the API key, the terms file and Read-only. - In Claude Desktop, open Customize, then Add › Upload plugin, and choose
legendkeeper-plugin.zip. - Start a new chat or Cowork task, so it picks up the new tools and skills.
See the README for full instructions. The extension isn't code-signed, so Claude Desktop may say so when you install it.
The icon directory is built from Font Awesome Free's metadata (MIT). Not affiliated with or endorsed by LegendKeeper or Fonticons.
v0.3.0
LegendKeeper for Claude Desktop, covering chat and Cowork, which runs inside Desktop.
New in 0.3.0
delete_asset: remove an image, map image, audio file or folder from the asset library, for example the old version after uploading a replacement.- A dry run names what would go, and for a folder counts everything inside it.
- A deleted image stays on pages that already show it, but its URL can't be added anywhere new.
- It needs an admin API key.
- MCP prompts:
summarize_topic,edit_page_safely,add_map_locationandsession_notes, ready-made requests for multi-step jobs. The write prompts appear only when writing is enabled. - Skills apply in chat too, not just Cowork. The wiki skill now covers replacing an image: upload, swap, delete the old one.
- Minimum Claude Desktop version: 3.6556.2.
Downloads
| File | What it is |
|---|---|
lk-mcp-darwin-arm64.mcpb |
Claude Desktop extension: the lk-mcp server (40 tools, 4 prompts) for Apple Silicon Macs. |
legendkeeper-plugin.zip |
Skills plugin: legendkeeper-wiki and legendkeeper-worldbuilding. |
SHA256SUMS |
Checksums. Check them with shasum -a 256 -c SHA256SUMS. |
Install or upgrade
- Double-click
lk-mcp-darwin-arm64.mcpb. If an older version is installed, Claude Desktop replaces it and keeps your settings: the API key, the terms file and Read-only. - In Claude Desktop, open Customize, then Add › Upload plugin, and choose
legendkeeper-plugin.zip. - Start a new chat or Cowork task, so it picks up the new tools and skills.
See the README for full instructions. The extension isn't code-signed, so Claude Desktop may say so when you install it.
Not affiliated with or endorsed by LegendKeeper.
v0.2.0
The first public release of the LegendKeeper integration for Claude Desktop, covering chat and Cowork, which runs inside Desktop.
Downloads
| File | What it is |
|---|---|
lk-mcp-darwin-arm64.mcpb |
Claude Desktop extension: the lk-mcp server (39 tools) for Apple Silicon Macs. Double-click to install. |
legendkeeper-plugin.zip |
Skills plugin: two skills, legendkeeper-wiki and legendkeeper-worldbuilding. Upload under Customize › Plugins › Add › Upload plugin. |
SHA256SUMS |
Checksums for both files. Check them with shasum -a 256 -c SHA256SUMS. |
Install
- Double-click
lk-mcp-darwin-arm64.mcpband enter a LegendKeeper API key. Use a test project first. - Leave Spoiler terms file empty for full DM access, or choose a file of protected terms (one per line) to turn on the spoiler guard.
- In a new chat, ask: "List my LegendKeeper projects."
- Optional: upload
legendkeeper-plugin.zipunder Customize › Plugins to add the skills. Cowork uses the same extension and skills automatically.
See the README for full instructions.
What's in it
- Read and write pages (as lossless LK Markdown), resources, documents, sidebar properties and images, plus maps, timelines, calendars, templates and boards.
- Safe writes:
- A versioned write never overwrites an edit made in the app since Claude read it.
- Every write tool has
dry_run. - Content Markdown can't express is kept.
- Optional spoiler guard: with a terms file, a write that would show a protected term to players is refused. Secret blocks and hidden pages, documents and properties may still hold those terms.
- The
lkGo SDK the server is built on:go get github.com/swiftj/golk/lk@v0.2.0.
Notes
- Apple Silicon macOS only for the Desktop extension. Linux binaries can be built from source (
make build). Windows and Intel Macs aren't supported. - The extension isn't signed, so Claude Desktop may say so when you install it.
Not affiliated with or endorsed by LegendKeeper.