Roo Logger

v1.0.0Developer Toolsstable

An MCP server for logging activity in Roo Code/Cline.

clinemcp-servermodel-context-protocolnodejsroo-code
Share:
24
Stars
0
Downloads
0
Weekly
0/5

What is Roo Logger?

Roo Logger is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server for logging activity in roo code/cline.

An MCP server for logging activity in Roo Code/Cline.

This server falls under the Developer Tools and Monitoring & Observability categories on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • An MCP server for logging activity in Roo Code/Cline.

Use Cases

Log activity and debug information from Roo Code and Cline editors.
annenpolka

Maintainer

LicenseMIT
Languagetypescript
Versionv1.0.0
UpdatedJan 28, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx roo-logger

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Roo Logger

Roo Activity Logger is a TypeScript MCP server that automatically records AI coding assistant activities — including command executions, code generation, file operations, errors, and decisions — as structured JSON log files. It works with Claude Code, Cline, Roo Code, and any MCP-compatible AI assistant. Logs include unique IDs, timestamps, intention, context, and parent-child relationships, making it easy to search activity history, restore task context, and audit what an AI agent did during a session.

Prerequisites

  • Node.js 18 or higher
  • npx available in PATH
  • An MCP client: Claude Code, Cline, or Roo Code
  • A writable directory on disk to store log files (absolute path required)
1

Add roo-logger to your MCP client configuration

Run the server directly from GitHub using npx without cloning the repository. Add it to your Claude Code, Cline, or Roo Code settings.

{
  "mcpServers": {
    "roo-activity-logger": {
      "command": "npx",
      "args": ["-y", "github:annenpolka/roo-logger"],
      "env": {},
      "disabled": false
    }
  }
}
2

Instruct your AI assistant to log activities

Add logging instructions to your CLAUDE.md (for Claude Code) or rules file (for Cline/Roo Code). Direct the assistant to use roo-activity-logger for all activities with a specific log directory.

## Logging
- Always use roo-activity-logger for all logs
- Log all command executions, code generation, and file operations
- Include intention and context for every log entry
- Use logsDir: /absolute/path/to/your/logs/activity
3

Log an activity

The log_activity tool records an activity with type, summary, intention, context, and the absolute path to the log directory. Supported types: command_execution, code_generation, file_operation, error_encountered, decision_made, conversation.

4

Search past logs

Use the search_logs tool to find past activities by type, log level, date range, or text. This is useful at the start of a session to restore context from previous work.

5

Build locally for customization

To modify the logger or run a local build, clone the repository and build with npm.

git clone https://github.com/annenpolka/roo-logger.git
cd roo-logger
npm install
npm run build

Roo Logger Examples

Client configuration

MCP configuration for Claude Code or Cline to run roo-logger via npx from GitHub.

{
  "mcpServers": {
    "roo-activity-logger": {
      "command": "npx",
      "args": ["-y", "github:annenpolka/roo-logger"],
      "env": {},
      "disabled": false
    }
  }
}

Prompts to try

Prompts that use roo-logger's log_activity and search_logs tools to track and recall AI assistant activities.

- "Search the activity logs from today for any command_execution entries related to npm."
- "Log this code generation activity: I generated a React hook for data fetching with intention to implement the user profile feature."
- "Search logs for any error_encountered entries from the last 7 days."
- "Review activity logs and summarize what was done on the authentication module last session."
- "Log a decision_made entry: chose PostgreSQL over MongoDB for the project database."

Troubleshooting Roo Logger

log_activity fails with 'logsDir must be an absolute path' error

The logsDir parameter requires an absolute path, not a relative one. Use a full path like /home/user/project/logs/activity rather than ./logs/activity. The directory will be created automatically if it does not exist.

npx github:annenpolka/roo-logger fails or is slow

npx fetches from GitHub on first run. Ensure you have an active internet connection and git is installed. Alternatively, clone the repo locally and point the config to the built dist/index.js: "command": "node", "args": ["/path/to/roo-logger/dist/index.js"]

search_logs returns no results even though activities were logged

Ensure the logsDir used in search_logs matches exactly the directory used when calling log_activity. Logs are stored as date-based JSON files in that directory. Check that the files exist at the specified path.

Frequently Asked Questions about Roo Logger

What is Roo Logger?

Roo Logger is a Model Context Protocol (MCP) server that mcp server for logging activity in roo code/cline. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Roo Logger?

Follow the installation instructions on the Roo Logger GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Roo Logger?

Roo Logger works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Roo Logger free to use?

Yes, Roo Logger is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "roo-logger": { "command": "npx", "args": ["-y", "roo-logger"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Roo Logger?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides