Which integrations are available for this server?

Provides tools for managing Scrapbox (Cosense) pages, including reading, writing, searching, and deleting pages, with support for both Markdown and Scrapbox content formats.

How do I use scrapbox-cosense-mcp-editable?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@scrapbox-cosense-mcp-editable Create 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

by qurihara

Overview Schema Source Related Servers Discussions Admin

Remote

scrapbox-cosense-mcp-editable

日本語ドキュメント / Japanese

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`	Get page content, metadata, and links	For private projects
`list_pages`	Browse pages with sorting and pagination (max 1000)	For private projects
`search_pages`	Full-text search with keyword highlighting (max 100 results)	For private projects
`create_page`	Create a page via WebSocket API with Markdown/Scrapbox body	Yes
`get_page_url`	Generate direct URL for a page	No
`insert_lines`	Insert text after a specified line in a page	Yes
`edit_lines`	Replace an exact-match line (one or all occurrences) with new content	Yes
`delete_page`	Delete a page by emptying every line via WebSocket patch	Yes
`get_smart_context`	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".

Related MCP server: MCP Server Demo

Quick Start

Desktop Extension (.mcpb) — Easiest

Download scrapbox-cosense-mcp-editable.mcpb from GitHub Releases
Double-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-editable

Install the plugin:
```
/plugin install scrapbox-cosense@worldnine-scrapbox-cosense-mcp
```
Installs globally by default. Use --scope project or --scope local for other scopes.
Set environment variables in your settings file:
```
{
  "env": {
    "COSENSE_PROJECT_NAME": "your_project_name",
    "COSENSE_SID": "your_sid"
  }
}
```
File
Scope
~/.claude/settings.json
All projects (global)
.claude/settings.local.json
This 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-mcp

Claude Desktop / Other MCP Clients

Add to your config file:

Client	Config File
Claude Desktop (macOS)	`~/Library/Application Support/Claude/claude_desktop_config.json`
Claude Desktop (Windows)	`%APPDATA%/Claude/claude_desktop_config.json`
Cursor	`.cursor/mcp.json` (project root)
Windsurf	`~/.codeium/windsurf/mcp_config.json`

{
  "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 build

Configuration

Required

Variable	Description
`COSENSE_PROJECT_NAME`	Your Scrapbox/Cosense project name
`COSENSE_SID`	Session ID (`connect.sid` cookie) for private projects — How to get it

Optional

Variable	Default	Description
`API_DOMAIN`	`scrapbox.io`	API domain
`SERVICE_LABEL`	`cosense (scrapbox)`	Display name in tool descriptions
`COSENSE_PAGE_LIMIT`	`100`	Initial page fetch limit (1–1000)
`COSENSE_SORT_METHOD`	`updated`	Initial sort: updated, created, accessed, linked, views, title
`COSENSE_TOOL_SUFFIX`	—	Tool name suffix for multiple instances (e.g. `main` → `get_page_main`)
`COSENSE_CONVERT_NUMBERED_LISTS`	`false`	Convert numbered lists to bullet lists in Markdown conversion
`COSENSE_EXCLUDE_PINNED`	`false`	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
`--compact`	Token-efficient compact output (recommended for AI agents)
`--project=NAME`	Override project name
`--json`	Output as JSON
`--help`	Show help (supports `<command> --help` for details)

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
`npm run build`	Build (TypeScript → JavaScript)
`npm run watch`	Auto-rebuild during development
`npm test`	Run test suite
`npm run lint`	Run ESLint
`npm run inspector`	Debug with MCP Inspector

Contributing

Create a feature branch from main
Add tests for your changes
Run npm run lint && npm test
Create a pull request — CI runs automatically

License

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive

ResponsivenessNo issues

Resources

Need Help?

Related Servers

Related MCP Connectors

docbaseOAuth
io.github.krayinc
DocBase MCP server for AI agents
Documentation Access Search Developer Tools
2
remnus AOAuth
io.github.Ranork
MCP-native open-source Notion alternative: read & write pages, databases and kanban boards.
Note Taking Project Management Workplace & Productivity
25373
slimaOAuth
io.github.slima-ai
MCP Server for Slima - AI Writing IDE for Novel Authors with AI Beta Reader.
Developer Tools
21
irenictableOAuth
org.benevolabs
Collaborative whiteboard MCP server — create objects, connectors, C4 diagrams, and manage boards
Design Tools Workplace & Productivity Software Architecture
2

Related MCP Servers

Scrapbox Cosense MCP Server
Content Management Systems Search
worldnine
A
license
A
quality
A
maintenance
This server facilitates interaction with cosense/Scrapbox projects, enabling users to retrieve, list, search, and create pages while supporting various query operations and secure access to private projects.
Updated 9 hours ago (2026-09-15 14:28 UTC)
9
230 npm
52
MIT
MCP Server Demo
Developer Tools Code Execution
elvisleyva49
A
license
Not graded
quality
D
maintenance
A minimal WebSocket-based MCP server implementation that enables modern tool integrations with VSCode, Claude, and other applications.
Updated a year ago (2025-07-07 00:54 UTC)
6 npm
ISC
notion-full-mcp
Note Taking Workplace & Productivity
cphoskins
A
license
A
quality
B
maintenance
Full-featured Notion MCP server enabling deep page reading, block editing, snapshot/restore, file uploads, table manipulation, page restore, and destructive page copying.
Updated 5 months ago (2026-04-09 02:22 UTC)
33
MIT
notion-mcp-server
Note Taking Project Management Workplace & Productivity
Gunthqq30223132
F
license
Not graded
quality
B
maintenance
MCP server enabling Gemini to interact with Notion Workspace via SSE, supporting reading and writing pages and databases through natural language.
Updated a month ago (2026-08-02 06:24 UTC)
-

File	Scope
`~/.claude/settings.json`	All projects (global)
`.claude/settings.local.json`	This project only (gitignored)

scrapbox-cosense-mcp-editable

Overview

Quick Start

Desktop Extension (.mcpb) — Easiest

Claude Code Plugin

Claude Code (Manual MCP Setup)

Claude Desktop / Other MCP Clients

Build from Source

Configuration

Required

Optional

CLI Usage

Multiple Projects

Development

Contributing

License

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

Scrapbox Cosense MCP Server

MCP Server Demo

notion-full-mcp

notion-mcp-server