scrapbox-cosense-mcp-editable
Provides tools for managing Scrapbox (Cosense) pages, including reading, writing, searching, and deleting pages, with support for both Markdown and Scrapbox content formats.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@scrapbox-cosense-mcp-editableCreate a page called 'Weekly Review' with my notes"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
scrapbox-cosense-mcp-editable
Overview
MCP server for Cosense (formerly Scrapbox). Fork of worldnine/scrapbox-cosense-mcp that adds page-deletion and line-editing tools (delete_page, edit_lines).
Tool | Description | Auth Required |
| Get page content, metadata, and links | For private projects |
| Browse pages with sorting and pagination (max 1000) | For private projects |
| Full-text search with keyword highlighting (max 100 results) | For private projects |
| Create a page via WebSocket API with Markdown/Scrapbox body | Yes |
| Generate direct URL for a page | No |
| Insert text after a specified line in a page | Yes |
| Replace an exact-match line (one or all occurrences) with new content | Yes |
| Delete a page by emptying every line via WebSocket patch | Yes |
| Get a page and its linked pages (1-hop/2-hop) in AI-optimized format | Yes |
create_page, insert_lines, and edit_lines support a format parameter ("markdown" or "scrapbox") to control content conversion.
Note on
delete_page: Cosense automatically removes a page once all of its lines are empty. This tool sends a WebSocket patch that returns an empty line array — there is no "undo".
Quick Start
Desktop Extension (.mcpb) — Easiest
Download
scrapbox-cosense-mcp-editable.mcpbfrom GitHub ReleasesDouble-click — Claude Desktop opens an install dialog
Enter your project name (and Session ID for private projects)
Claude Code Plugin
Add the marketplace:
/plugin marketplace add qurihara/scrapbox-cosense-mcp-editableInstall the plugin:
/plugin install scrapbox-cosense@worldnine-scrapbox-cosense-mcpInstalls globally by default. Use
--scope projector--scope localfor other scopes.Set environment variables in your settings file:
{ "env": { "COSENSE_PROJECT_NAME": "your_project_name", "COSENSE_SID": "your_sid" } }File
Scope
~/.claude/settings.jsonAll projects (global)
.claude/settings.local.jsonThis project only (gitignored)
The plugin includes MCP server configuration and a /cosense skill for CLI operations.
Claude Code (Manual MCP Setup)
If you prefer manual configuration over the plugin:
claude mcp add scrapbox-cosense-mcp \
-e COSENSE_PROJECT_NAME=your_project \
-e COSENSE_SID=your_sid \
-- npx -y scrapbox-cosense-mcpClaude Desktop / Other MCP Clients
Add to your config file:
Client | Config File |
Claude Desktop (macOS) |
|
Claude Desktop (Windows) |
|
Cursor |
|
Windsurf |
|
{
"mcpServers": {
"scrapbox-cosense-mcp": {
"command": "npx",
"args": ["-y", "scrapbox-cosense-mcp"],
"env": {
"COSENSE_PROJECT_NAME": "your_project_name",
"COSENSE_SID": "your_sid"
}
}
}
}Build from Source
git clone https://github.com/qurihara/scrapbox-cosense-mcp-editable.git
cd scrapbox-cosense-mcp-editable
npm install && npm run buildConfiguration
Required
Variable | Description |
| Your Scrapbox/Cosense project name |
| Session ID ( |
Optional
Variable | Default | Description |
|
| API domain |
|
| Display name in tool descriptions |
|
| Initial page fetch limit (1–1000) |
|
| Initial sort: updated, created, accessed, linked, views, title |
| — | Tool name suffix for multiple instances (e.g. |
|
| Convert numbered lists to bullet lists in Markdown conversion |
|
| Exclude pinned pages from initial resource list |
CLI Usage
The same binary also works as a standalone CLI:
scrapbox-cosense-mcp get "Page Title"
scrapbox-cosense-mcp search "keyword"
scrapbox-cosense-mcp list --sort=updated --limit=20
scrapbox-cosense-mcp create "New Page" --body="Markdown content"
scrapbox-cosense-mcp insert "Page" --after="target line" --text="new text"
scrapbox-cosense-mcp url "Page Title"Flag | Description |
| Token-efficient compact output (recommended for AI agents) |
| Override project name |
| Output as JSON |
| Show help (supports |
Multiple Projects
All tools accept an optional projectName parameter to target a different project from a single server. For multiple private projects with different credentials, run separate server instances with COSENSE_TOOL_SUFFIX.
See docs/multiple-projects.md for detailed configuration examples.
Development
Command | Description |
| Build (TypeScript → JavaScript) |
| Auto-rebuild during development |
| Run test suite |
| Run ESLint |
| Debug with MCP Inspector |
Contributing
Create a feature branch from
mainAdd tests for your changes
Run
npm run lint && npm testCreate a pull request — CI runs automatically
License
MIT
This server cannot be installed
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/qurihara/scrapbox-cosense-mcp-editable'
If you have feedback or need assistance with the MCP directory API, please join our Discord server