ManicTimeMcp.any
0.2.15
dotnet add package ManicTimeMcp.any --version 0.2.15
NuGet\Install-Package ManicTimeMcp.any -Version 0.2.15
<PackageReference Include="ManicTimeMcp.any" Version="0.2.15" />
<PackageVersion Include="ManicTimeMcp.any" Version="0.2.15" />
<PackageReference Include="ManicTimeMcp.any" />
paket add ManicTimeMcp.any --version 0.2.15
#r "nuget: ManicTimeMcp.any, 0.2.15"
#:package ManicTimeMcp.any@0.2.15
#addin nuget:?package=ManicTimeMcp.any&version=0.2.15
#tool nuget:?package=ManicTimeMcp.any&version=0.2.15
ManicTime MCP
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
- Read
spec/README.mdfor workstream specifications. - Pick a workstream and implement only that scope.
- See
AGENTS.mdfor build commands, quality rules, and constraints.
License
MIT
Learn more about Target Frameworks and .NET Standard.
This package has no dependencies.
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.