cosense-mcp-server

by yosider

5 stars

174 downloads

Not rated

GitHub Website

About

The cosense-mcp-server facilitates the integration with Claude Desktop by serving as a middleware command pipeline server, allowing for interaction with projects in cosense.

Details

Author: yosider
Repository: yosider/cosense-mcp-server
GitHub stars: 5
Downloads: 174
Categories: Developer Tools, AI, Other

Setting up with Highlight

Follow these steps to add this server as a custom Highlight plugin:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below
Plugin Name cosense-mcp-server

Command (node, npx, python, etc.) npx
Arguments
- Argument 1 -y
- Argument 2 @yosider/cosense-mcp-server
Environment
- COSENSE_SID your_sid
- COSENSE_PROJECT_NAME your_project_name
Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

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

JSON

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

JSON

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

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

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

JSON

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

JSON

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

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

From the repository

If you prefer to run the server from a local copy of this repository, build it first:

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

Then configure your MCP client to use the local build:

{
  "mcpServers": {
    "cosense-mcp-server": {
      "command": "node",
      "args": ["/path/to/cosense-mcp-server/build/index.js"],
      "env": {
        "COSENSE_PROJECT_NAME": "your_project_name",
        "COSENSE_SID": "your_sid"
      }
    }
  }
}

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

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

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

Linux

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

Macos

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

Windows

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

Cosense MCP Server

A MCP server for Cosense.

Tools

The following tools are available for interacting with Cosense pages:

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": {
        "COSENSE_PROJECT_NAME": "your_project_name",
        "COSENSE_SID": "your_sid"
      }
    }
  }
}

Development

Running from Source

If you prefer to run the server from a local copy of this repository, build it first:

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

Then configure your MCP client to use the local build:

{
  "mcpServers": {
    "cosense-mcp-server": {
      "command": "node",
      "args": ["/path/to/cosense-mcp-server/build/index.js"],
      "env": {
        "COSENSE_PROJECT_NAME": "your_project_name",
        "COSENSE_SID": "your_sid"
      }
    }
  }
}

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector, which is available as a package script:

pnpm run inspect

The Inspector will provide a URL to access debugging tools in your browser.

Acknowledgments

This project is forked from funwarioisii/cosense-mcp-server.

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

get_page

list_pages

search_pages

insert_lines

Claude Desktop / Cursor

Linux

Macos

Windows

Cosense MCP Server

Tools

Installation

Prerequisites

For VS Code Users

For Claude Desktop Users

Using pnpm

Using yarn

Using npx

Development

Running from Source

Debugging

Acknowledgments

Install

More like this

Sequential Thinking

Sentry

Github

Filesystem

EverArt

Google Drive

`get_page`

`list_pages`

`search_pages`

`insert_lines`