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

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:

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 ~/.npmrc

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

... [View full README on GitHub](https://github.com/yosider/cosense-mcp-server#readme)