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

MCP Client Configuration

The following environment variables are required:

COSENSE_PROJECT_NAME: Project name
COSENSE_SID: Session ID for authentication
- Required for writing to pages and reading private pages
- Handle with care as it contains sensitive information
- For more details, see scrapboxlab/connect.sid

Run from npm registry

JSR registry configuration

This package depends on @cosense/std and @cosense/types which are hosted on JSR. Before using npx, you need to configure the JSR registry globally:

For Linux/macOS:

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

For Windows (PowerShell):

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

Or if you prefer not to modify global settings, run from source instead (see the section below)

Client json configuration

After configuring JSR registry, configure your MCP client:

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

Run from source

Clone and build

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

Client json configuration

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