RewindMCP MCP Server

A Python library for interfacing with the Rewind.ai SQLite database.

Local serverstdioPython

What is the RewindMCP MCP server?

A Python library for interfacing with the Rewind.ai SQLite database. The rewindmcp mcp server wraps that behind the Model Context Protocol, so an assistant can use it through 8 defined tools rather than through you.

Its toolset

Everything the assistant can do here goes through one of these:

  • Parameters — time_period (required, e.g., '1hour', '30minutes', '1day', '1week'), application (optional, filter by app name)
  • Returns — Frame count per application, OCR node count (activity level), number of unique windows, time range when application was active, sorted by activity
  • Prerequisites — The Prerequisites tool exposed by this server
  • Frames — Screenshots captured by Rewind.ai at regular intervals as you use your computer. Each frame in the frame table includes a timestamp (createdAt) and
  • Nodes — Text elements extracted from screen captures using Optical Character Recognition (OCR). Each node in the node table represents a piece of text
  • SearchRanking_Content — This table stores the actual OCR text content extracted from screen captures. It contains three columns: - id: A unique identifier that can be used
  • Segments — Application usage sessions that track when you were using specific applications and windows. Each segment in the segment table includes the
  • Events — Calendar events and meetings that were scheduled during your computer usage. The event table stores information about these events, including title

Configuration

You will need 2 environment variables: REWIND_DB_PATH, REWIND_DB_PASSWORD. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

  • Python 3.6+

Adding it to your client

Installation goes through your MCP client rather than a global install: point it at wordcloud on PyPI and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.

When to reach for it

Plenty of database access servers cover similar ground. The differences that matter in practice are scope of access and how much setup stands between you and a working tool call. RewindMCP's toolset — Parameters, Returns, Prerequisites and 5 more — is a fair guide to whether it matches your workflow. It is maintained by pedramamini; worth a glance at recent repository activity before you build anything load-bearing on it.

SyncDev reviews every entry in this directory against the project's own documentation before publishing, and revisits them as servers change.

Caveats

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the rewindmcp mcp server does with a few real requests.

Available tools

ToolWhat it does
Parameterstime_period (required, e.g., '1hour', '30minutes', '1day', '1week'), application (optional, filter by app name)
ReturnsFrame count per application, OCR node count (activity level), number of unique windows, time range when application was active, sorted by activity level
PrerequisitesThe Prerequisites tool exposed by this server.
FramesScreenshots captured by Rewind.ai at regular intervals as you use your computer. Each frame in the frame table includes a timestamp (createdAt) and is linked to the application segment it belongs to. Frames are the visua
NodesText elements extracted from screen captures using Optical Character Recognition (OCR). Each node in the node table represents a piece of text visible on your screen, including its position (leftX, topY, width, height) a
SearchRanking_ContentThis table stores the actual OCR text content extracted from screen captures. It contains three columns: - id: A unique identifier that can be used to locate the corresponding recording chunk - c0: The main text content
SegmentsApplication usage sessions that track when you were using specific applications and windows. Each segment in the segment table includes the application bundle ID, window name, start time, and end time. Segments help orga
EventsCalendar events and meetings that were scheduled during your computer usage. The event table stores information about these events, including title, start time, end time, and other metadata. Events provide additional con

How to install the RewindMCP MCP server

{
  "mcpServers": {
    "rewinddb": {
      "command": "python",
      "args": ["/path/to/mcp_stdio.py"],
      "env": {
        "REWIND_DB_PATH": "/path/to/your/rewind.db",
        "REWIND_DB_PASSWORD": "your_password"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

  • Python 3.6+
VariableDescriptionRequired
REWIND_DB_PATHFilesystem location the server is allowed to use.Optional
REWIND_DB_PASSWORDConfiguration value read at startup.Optional

Example prompts to try

  • Use RewindMCP to Parameters.
  • Use RewindMCP to Returns.
  • Use RewindMCP to Prerequisites.

Frequently asked questions

It connects RewindMCP to MCP-compatible AI assistants such as Claude and Cursor, exposing 8 tools (Parameters, Returns, Prerequisites, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with RewindMCP directly.