Cosense MCP Server
@yosider
About Cosense MCP Server
An MCP Server for Cosense
Basic information
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"
}
}
}
}Tools
4Retrieves 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
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).
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.
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.
More Other MCP servers
Reactive Resume
amruthpillaiA one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!
🪟 Windows-MCP
CursorTouchMCP Server for Computer Use in Windows
MCP Go 🚀
mark3labsA Go implementation of the Model Context Protocol (MCP), enabling seamless integration between LLM applications and external data sources and tools.
FastMCP v2 🚀
jlowin🚀 The fast, Pythonic way to build MCP servers and clients.
🚀 Model Context Protocol (MCP) Curriculum for Beginners
microsoftThis open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,
Comments