Which integrations are available for this server?

The server depends on packages hosted on [JSR](/mcp/servers/integrations/jsr) registry (@cosense/std and @cosense/types) and requires configuration to access these dependencies. Provides tools to interact with Cosense pages, which are part of the [Scrapbox](/mcp/servers/integrations/scrapbox) ecosystem. Features include retrieving pages, listing available pages, searching pages, and inserting text into pages.

Cosense MCP Server

A MCP server for Cosense.

Tools

The following tools are available for interacting with Cosense pages:

get_page: Retrieves a page with the specified title
list_pages: Lists available pages in the resources
search_pages: Searches for pages containing the specified query string
insert_lines: Inserts text after a specified line in a page

Related MCP server: Cosense MCP Server

Installation

Prerequisites

Set the following environment variables:

COSENSE_PROJECT_NAME — your Cosense project name.
COSENSE_SID — session cookie used for authentication. Required for writing pages and reading private pages. Treat this like a secret. See https://scrapbox.io/scrapboxlab/connect.sid for more details.

For VS Code Users

Use one of these one-click installation buttons:

Install with pnpm in VS Code Install with pnpm in VS Code Insiders

Install with yarn in VS Code Install with yarn in VS Code Insiders

Note: After clicking the button, replace your_project_name and your_sid with your actual values in the configuration. For manual setup, you can also edit .vscode/mcp.json directly.

For Claude Desktop Users

Add one of the following configurations to your claude_desktop_config.json:

Using pnpm

{ "mcpServers": { "cosense-mcp-server": { "command": "pnpm", "args": ["-s", "dlx", "@yosider/cosense-mcp-server"], "env": { "COSENSE_PROJECT_NAME": "your_project_name", "COSENSE_SID": "your_sid" } } } }

Using yarn

{ "mcpServers": { "cosense-mcp-server": { "command": "yarn", "args": ["dlx", "-q", "@yosider/cosense-mcp-server"], "env": { "COSENSE_PROJECT_NAME": "your_project_name", "COSENSE_SID": "your_sid" } } } }

Using npx

This package depends on JSR-hosted packages. npx requires adding the JSR registry to ~/.npmrc first.

Step 1: Add JSR registry to

Linux/macOS:

echo "@jsr:registry=https://npm.jsr.io" >> ~/.npmrc

Windows (PowerShell):

echo "@jsr:registry=https://npm.jsr.io" >> $env:USERPROFILE\\.npmrc

Step 2: Add configuration

{ "mcpServers": { "cosense-mcp-server": { "command": "npx", "args": ["-y", "@yosider/cosense-mcp-server"], "env": { "COSENSE_PROJECT_NAME": "your_project_name", "COSENSE_SID": "your_sid" } } } }

Development

Running from Source

If you prefer to run the server from a local copy of this repository, build it first:

git clone https://github.com/yosider/cosense-mcp-server.git cd cosense-mcp-server pnpm install pnpm run build

Then configure your MCP client to use the local build:

{ "mcpServers": { "cosense-mcp-server": { "command": "node", "args": ["/path/to/cosense-mcp-server/build/index.js"], "env": { "COSENSE_PROJECT_NAME": "your_project_name", "COSENSE_SID": "your_sid" } } } }