What can you do with this server?

The Scrapbox Cosense MCP Server allows you to interact with Scrapbox/Cosense projects programmatically with these key capabilities: * Get Pages: Retrieve page content, metadata, links, and editor information by title * List Pages: View pages with flexible sorting options (updated, created, accessed, linked, views, title), pagination support, and the ability to exclude pinned pages * Search Pages: Perform full-text searches using basic keywords, AND search, NOT exclusions, and exact phrase queries (up to 100 results) * Create Pages: Generate new pages with a title and optional markdown body text, which opens in your browser

Which integrations are available for this server?

Provides access to Scrapbox/Cosense pages, allowing retrieval of page content, metadata, links, and editor information, listing pages in a project, full-text search across pages, and generating page URLs.

How do I use Scrapbox Cosense MCP Server?

1. Click on "Install 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 Server search for pages about JavaScript tutorials" 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.

de en es ja ko ru zh

Scrapbox Cosense MCP Server

by worldnine

Overview Schema Related Servers Score Discussions

Hybrid

scrapbox-cosense-mcp

日本語ドキュメント / Japanese

Overview

MCP server for Cosense (formerly Scrapbox).

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
`get_smart_context`	Get a page and its linked pages (1-hop/2-hop) in AI-optimized format	Yes

create_page and insert_lines support a format parameter ("markdown" or "scrapbox") to control content conversion.

Related MCP server: MCP File System Server

Quick Start

Desktop Extension (.mcpb) — Easiest

Download scrapbox-cosense-mcp.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 worldnine/scrapbox-cosense-mcp

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/worldnine/scrapbox-cosense-mcp.git
cd scrapbox-cosense-mcp
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

Install Server

security – no known vulnerabilities

license - permissive license

quality - not tested

How are these scores calculated?

Resources

Need Help?

Reddit Discussion

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Appeared in Searches

Latest Blog Posts

Tool Definition Quality Score (TDQS)
By punkpeye on April 3, 2026.
mcp
The Hackers Who Tracked My Sleep Cycle
By punkpeye on March 26, 2026.
security
Open Source Has a Bot Problem
By punkpeye on March 19, 2026.
open source

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/worldnine/scrapbox-cosense-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

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