Cosense

Cosense MCP Server lets you run a local MCP endpoint that communicates with Cosense pages, enabling automated interactions and scripting against Cosense resources from your development environment.

How to use

You use the Cosense MCP Server by running it locally and connecting your MCP client to the provided stdio endpoint. Start the server with the runtime command shown below, then configure your client to launch the server process and communicate through its standard input/output streams. You can also use a preconfigured setup in your development environment to simplify starting the server.

How to install

Prerequisites you must prepare before starting the server:

• COSENSE_PROJECT_NAME — your Cosense project name
• COSENSE_SID — session cookie used for authentication. Treat this as a secret. Requires access to private pages.

Choose one of the following setup paths based on your environment.

For Claude Desktop users, add one of these configurations to claude_desktop_config.json. Use your actual values for the environment variables.

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

Alternatively, you can configure using pnpm for VS Code or other tooling. After implementing, replace your_project_name and your_sid with the actual values.

If you prefer yarn, add a similar configuration using yarn instead of pnpm.

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

Additional setup notes

If you prefer a local, manual setup, you can also run the server from source after building. You will configure a client to execute the final start command that runs the built server.

# Example local development flow
pnpm install
pnpm run build

# Start command to be used by the MCP client
node /path/to/cosense-mcp-server/build/index.js

Available tools

get_page

Retrieves a page with the specified title.

list_pages

Lists available pages in the resources.

search_pages

Searches for pages containing a specific query string.

insert_lines

Inserts text after a specified line in a page.