Cosense MCP Server

Name: Cosense MCP Server
Author: yosider

@yosider

代码仓库主页

关于 Cosense MCP Server

An MCP Server for Cosense

基本信息

分类

其他

运行时

node

传输方式

stdio

发布者

yosider

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

Retrieves a page with the specified title

Lists available pages in the resources

Searches for pages containing the specified query string

Inserts text after a specified line in a page

概览

What is Cosense MCP Server?

Cosense MCP Server is a Model Context Protocol server that enables AI assistants to read and write pages in a Cosense (formerly Scrapbox) project. It provides tools for retrieving, searching, listing, and modifying pages, making it useful for developers and knowledge workers who want to integrate Cosense with MCP-compatible clients like VS Code and Claude Desktop.

How to use Cosense MCP Server?

Set two environment variables — COSENSE_PROJECT_NAME and COSENSE_SID — then configure your MCP client. For VS Code, use one-click install buttons or edit .vscode/mcp.json manually. For Claude Desktop, add a configuration entry using pnpm, yarn, or npx to claude_desktop_config.json. The server exposes four tools: get_page, list_pages, search_pages, and insert_lines.

Key features of Cosense MCP Server

Retrieve a page by its title
List available pages in the project
Search pages by query string
Insert text after a specified line
Requires session cookie for write and private-page access

Use cases of Cosense MCP Server

AI assistant searches Cosense for relevant documentation to answer a user query
Automatically appends meeting notes or logs to a Cosense page
Developer reads project wiki pages from within VS Code via MCP tools
Curates a Cosense project by programmatically inserting structured content

FAQ from Cosense MCP Server

What tools does Cosense MCP Server provide?

It provides get_page, list_pages, search_pages, and insert_lines for reading and writing Cosense pages.

What authentication is required?

You must set the COSENSE_SID environment variable — a session cookie used for authentication. It is required for writing pages and reading private pages. Treat it like a secret.

What runtime dependencies does it have?

The server is distributed as an npm package (@yosider/cosense-mcp-server) and depends on JSR-hosted packages. It can be run via pnpm, yarn, or npx (with JSR registry configured for npx).