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
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.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/scrapbox-cosense-mcpDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad 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_NAMErequired- Cosense project name.
COSENSE_MCP_PATsecret- 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.
Related
MCP serversA skill and command-line harness that read, search and edit Cosense (formerly Scrapbox) pages directly from Claude Code and Codex.
An MCP server for a BookStack wiki: read and search by default, writes enabled separately, rights taken from the token.
A team wiki living in Git with a 51-tool MCP server: agents read and edit pages, tables and boards.
The official Kibela MCP server searches, reads and edits notes, folders and comments of your wiki straight from an assistant chat
A local wiki memory built from what you read: a shared knowledge folder for agents through an MCP bridge and my-curator.
mcp-logseq: MCP server for Logseq
MCP server for LogSeq
MCP server for Logseq: the agent reads, searches and edits pages and blocks of your graph over the local HTTP API
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.