ManicTimeMcp 0.2.15

.NET 10.0 This package targets .NET 10.0. The package is compatible with this framework or higher. 
{
  "servers": {
    "ManicTimeMcp": {
      "type": "stdio",
      "command": "dnx",
      "args": ["ManicTimeMcp@0.2.15", "--yes"]
    }
  }
}
This package contains an MCP Server. The server can be used in VS Code by copying the generated JSON to your VS Code workspace's .vscode/mcp.json settings file. 
dotnet tool install --global ManicTimeMcp --version 0.2.15
This package contains a .NET tool you can call from the shell/command line. 
dotnet new tool-manifest
                    


                            if you are setting up this repo
                        

                    

                
dotnet tool install --local ManicTimeMcp --version 0.2.15
This package contains a .NET tool you can call from the shell/command line. 
#tool dotnet:?package=ManicTimeMcp&version=0.2.15
                    


                    

                
nuke :add-package ManicTimeMcp --version 0.2.15

ManicTime MCP

NuGet

A .NET MCP server that gives AI agents read-only access to your local ManicTime activity data — applications, documents, websites, screenshots, and usage patterns.

Compatibility notice — This project is an independent integration and is not affiliated with or endorsed by ManicTime or Finkit.

Quick start

Requires the .NET 10+ SDK. Run directly with dnx — no install step needed:

dnx -y ManicTimeMcp

This downloads the latest version and starts the server over stdio. It expects a local ManicTime Windows desktop installation with local storage.

Agent configuration

Visual Studio / VS Code (Copilot)

The package embeds a .mcp/server.json manifest. Browse ManicTimeMcp on NuGet.org, open the MCP Server tab, and copy the configuration into your IDE.

Or add manually to .vscode/mcp.json:

{
  "servers": {
    "manictime-mcp": {
      "type": "stdio",
      "command": "dnx",
      "args": ["-y", "ManicTimeMcp"]
    }
  }
}

Claude Code

claude mcp add manictime-mcp -- dnx -y ManicTimeMcp

Claude Desktop

Add to claude_desktop_config.json (%APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "manictime-mcp": {
      "command": "dnx",
      "args": ["-y", "ManicTimeMcp"]
    }
  }
}

OpenAI Codex CLI

codex mcp add manictime-mcp -- dnx -y ManicTimeMcp

Generic MCP JSON configuration

For any MCP-compatible client that accepts a JSON config:

{
  "mcpServers": {
    "manictime-mcp": {
      "command": "dnx",
      "args": ["-y", "ManicTimeMcp"],
      "transportType": "stdio"
    }
  }
}

What it provides

Tools

Tool Description
get_daily_summary Structured summary for a single day — segments, top apps, websites, screenshots
get_activity_narrative "What did I do?" for a date range — segments with documents, websites, tags
get_period_summary Multi-day overview with per-day breakdown and day-of-week patterns
get_website_usage Website usage with hourly or daily breakdown
get_timelines List available ManicTime timelines
get_activities Raw activities from a specific timeline
list_screenshots Discover screenshots with metadata (zero image bytes)
get_screenshot Retrieve a screenshot — thumbnail for model, full-size for human
crop_screenshot Crop a region of interest from a screenshot
save_screenshot Save a screenshot to disk within MCP client roots

Resources

Resource Description
manictime://health Server health and database status
manictime://guide Usage guide for AI models — tool workflows, decision trees, playbooks
manictime://environment Device and OS information
manictime://data-range Available data date boundaries
manictime://screenshot/{ref} Lazy-fetch screenshot by reference

Prompts

Prompt Description
daily_review "Summarize my activities for {date}"
weekly_review "Summarize my week from {startDate} to {endDate}"
screenshot_investigation "What was I doing at {datetime}?"

Supported scope

  • Supported: ManicTime Windows desktop with local storage (ManicTimeReports.db).
  • Not supported (v1): ManicTime Server deployments, non-Windows clients, server-centric collectors.
  • Transport: stdio only.

Building from source

dotnet restore src/ManicTimeMcp.slnx
dotnet build src/ManicTimeMcp.slnx -warnaserror
dotnet test --solution src/ManicTimeMcp.slnx

See docs/getting-started.md for prerequisites and AGENTS.md for engineering rules.

Contributing

  1. Read spec/README.md for workstream specifications.
  2. Pick a workstream and implement only that scope.
  3. See AGENTS.md for build commands, quality rules, and constraints.

License

MIT

Product Compatible and additional computed target framework versions.
.NET net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

Version Downloads Last Updated
0.2.15 100 2/17/2026
0.2.14 84 2/17/2026
0.2.6 84 2/17/2026