Advertise
MCP.so
Sign In

Cosense MCP Server

@yosider

RepositoryHomepage

Basic information

Category

Other

Transports

stdio

Author

yosider

About Cosense MCP Server

An MCP Server for Cosense

Cosense MCP Server config

Add this server to your MCP-compatible client using the configuration below.

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

Cosense MCP Server tools

4

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

Overview

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

Frequently asked questions

1

What tools does Cosense MCP Server provide?

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

2

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.

3

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`).

4

Where does data live?

Data stays in your Cosense project. The server acts as a bridge — it does not store or cache pages outside Cosense.

5

How do I debug the server?

The README recommends using the MCP Inspector, which can be run via `pnpm run inspect` from a local clone of the repository.

Comments

More Other MCP servers

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K

MCP Toolbox for Databases

googleapis

MCP Toolbox for Databases is an open source MCP server for databases.

15.9K

Figs, Relationship Expert

Figs O'Sullivan, LMFT

Couples therapist Figs O'Sullivan (LMFT, 17 years, endorsed by Sue Johnson, creator of EFT) inside your AI. Ask relationship questions answered from his clinical writing, name the pattern in a fight, get a three-step rep

Klarix Intelligence Engine

Klarix

B2B competitive intelligence, live sales battlecards, 5-axis ICP prospect fit scoring, and tech stack teardowns over MCP and REST with cited public-web evidence.

Screenpipe

screenpipe

YC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context

22.0K
Advertise