scrapbox-cosense-mcp

An MCP server for Cosense (Scrapbox): an agent reads, searches, creates and edits wiki pages, deletion is opt-in.

  • 55 ★ on the repository
  • Last commit
  • MIT
MCP server

Broad access

Why this level

  • It creates, edits and, when enabled, deletes wiki pages with an access token.
  • A token may reach more projects than the agent needs.
All reasons and checks

worldnine/scrapbox-cosense-mcp

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/scrapbox-cosense-mcp

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • It creates, edits and, when enabled, deletes wiki pages with an access token.
  • A token may reach more projects than the agent needs.

This is third-party code. Review the repository files before installing.

What it does

scrapbox-cosense-mcp connects Claude and other agents to a Cosense wiki, formerly Scrapbox. The tools `get_page`, `list_pages` and `search_pages` read and search, `create_page`, `insert_lines`, `edit_lines` and `delete_lines` edit pages line by line by exact match, and `get_smart_context` returns a page with its linked pages in an AI-friendly form. Content is accepted in Markdown or Scrapbox format. Page deletion `delete_page` and full rewrite `rewrite_page` are not registered unless `COSENSE_ENABLE_DELETE=true` is set. `COSENSE_PROJECT_ALLOW_LIST` limits reachable projects. The server also works as a CLI and as a Claude Code plugin with a scrapbox skill.

Who it is for. Teams that keep notes and a knowledge base in Cosense and want an agent to find and extend pages.

Good fit when

  • Pages must be found in the wiki by keyword with highlighting and linked ones read.
  • An agent must append lines to an existing page without touching the rest.
  • Chat notes should become a new page written in Markdown.
  • One server serves several Cosense projects with different credentials.

Not a fit when

  • The wiki is private and there is no access token.
  • Pages must be deleted in bulk with no review.
  • The agent may only read and edits are unwanted.

Example request

Find the release pages in Cosense, read the linked ones and append the summary to the Plan page.

MCP

Transport
stdio
Authentication
key is optional

Environment variables

COSENSE_PROJECT_NAME required
Cosense project name.
COSENSE_MCP_PAT secret
Personal access token for private projects and writes.
COSENSE_ENABLE_DELETE
`true` registers `delete_page` and `rewrite_page`.
COSENSE_PROJECT_ALLOW_LIST
Allow list of reachable projects.

Limitations

Private projects need the access token `COSENSE_MCP_PAT` or a session id, while public pages read without them. A token often reaches more projects than needed, so set `COSENSE_PROJECT_ALLOW_LIST`. Deletion is irreversible, and `rewrite_page` loses a concurrent edit that lands mid-rewrite. `dryRun` exists for checks. `edit_lines` and `delete_lines` change only the first match by default.

How to disable. Remove the server from client settings and uninstall the plugin through `/plugin` or the `.mcpb` extension. Revoke the token in Cosense settings.

FAQ

How do I install it in Claude Code?

Through the plugin: `/plugin marketplace add worldnine/scrapbox-cosense-mcp`, then `/plugin install scrapbox-cosense@worldnine-scrapbox-cosense-mcp`. You can also add `npx -y scrapbox-cosense-mcp` with `claude mcp add`.

How do I enable deletion?

Set `COSENSE_ENABLE_DELETE=true`. Without it `delete_page` and `rewrite_page` do not appear in the tool list.

How do I limit projects?

The `COSENSE_PROJECT_ALLOW_LIST` variable lists reachable projects. It guards against a token that opens too much.

Can I connect two projects?

Yes. Run two server entries with different `COSENSE_PROJECT_NAME` and `COSENSE_TOOL_SUFFIX` values and the tools get different suffixes.

What does dryRun do?

It reports how many lines would be removed or replaced and shows the first five, without touching the page.

Discussion

No questions or reviews yet.

A skill and command-line harness that read, search and edit Cosense (formerly Scrapbox) pages directly from Claude Code and Codex.

SkillExtended access165Repository stars

An MCP server for a BookStack wiki: read and search by default, writes enabled separately, rights taken from the token.

MCP serverExtended access55Repository stars
Official

A team wiki living in Git with a 51-tool MCP server: agents read and edit pages, tables and boards.

MCP serverExtended access87Repository stars
Official

The official Kibela MCP server searches, reads and edits notes, folders and comments of your wiki straight from an assistant chat

MCP serverExtended access16Repository stars

A local wiki memory built from what you read: a shared knowledge folder for agents through an MCP bridge and my-curator.

MCP serverExtended access103Repository stars

MCP server for Logseq: the agent reads, searches and edits pages and blocks of your graph over the local HTTP API

MCP serverBroad access351Repository stars

README in short

Line edits go by exact match, so the agent must read a page first. Destructive operations stay hidden until enabled and have a dry-run mode.

README badge

Report a problem