timps

Local

github.com/TIMPSsMemory & Knowledge0Updated 6w ago

About timps

timps is a persistent memory MCP server for coding assistants such as Claude, Cursor, and Windsurf. It provides tools for recalling information across sessions, detecting contradictions, and tracking code, decisions, and developer signals.

Key features

01Store and retrieve persistent memories
02Detect contradictions in recorded positions
03Track decisions and commitments
04Identify bug patterns and architecture drift
05Monitor burnout signals
06Query causal and knowledge graphs

Use cases

01Recall project context in a later session
02Check a new statement against prior positions
03Track decisions and outstanding commitments
04Review code risks and burnout signals

MCP support

timps exposes memory and developer-intelligence tools through MCP. It can proxy to a TIMPS HTTP server or run its MemoryEngine directly in local mode.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config

{
  "mcpServers": {
    "sandeeprdy1729-timps": {
      "command": "npx",
      "args": [
        "-y",
        "@timps-ai/timps-mcp"
      ],
      "env": {
        "TIMPS_URL": "<TIMPS_URL>",
        "TIMPS_MEMORY_URL": "<TIMPS_MEMORY_URL>",
        "TIMPS_API_KEY": "<TIMPS_API_KEY>",
        "TIMPS_PROJECT_PATH": "<TIMPS_PROJECT_PATH>"
      }
    }
  }
}

Run commandnpx -y @timps-ai/timps-mcp

Environment variables to set

TIMPS_URLURL of the TIMPS MemoryServer (e.g. http://localhost:4100). If not set, uses local file-based memory.

TIMPS_MEMORY_URLURL of the TIMPS MemoryServer for memory operations. Set to same as TIMPS_URL when using the full stack.

TIMPS_API_KEYSecretAPI key for authenticating with TIMPS MemoryServer. Generate via POST /auth/key on the server.

TIMPS_PROJECT_PATHProject path for local memory storage. Defaults to current working directory.

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages

npm@timps-ai/timps-mcp2.0.3stdio

Tools

Saved tool list · updated 2w ago

Parameter	Type	Required	Description
message	string	Yes	Message to send to TIMPs
username	string	No	Optional username

Details

From the project README

@timps-ai/timps-mcp — Persistent Memory for Claude, Cursor, and Windsurf

45 MCP tools that give your AI coding assistant persistent memory across sessions — contradiction detection, bug patterns, burnout monitoring, architecture drift, and 22-layer memory forge.

npm install -g @timps-ai/timps-mcp

Add to your AI tool

Claude Code (`~/.claude.json`)

{
  "mcpServers": {
    "timps": {
      "command": "timps-mcp",
      "env": { "TIMPS_URL": "http://localhost:3000", "TIMPS_USER_ID": "1" }
    }
  }
}

Cursor (`~/.cursor/mcp.json`)

{
  "mcpServers": {
    "timps": {
      "command": "timps-mcp",
      "env": { "TIMPS_URL": "http://localhost:3000", "TIMPS_USER_ID": "1" }
    }
  }
}

Windsurf (`~/.codeium/windsurf/mcp_config.json`)

{
  "mcpServers": {
    "timps": {
      "command": "timps-mcp",
      "env": { "TIMPS_URL": "http://localhost:3000", "TIMPS_USER_ID": "1" }
    }
  }
}

Two modes

Mode	Config	Backend
SERVER (default)	`TIMPS_URL` set	Proxies to TIMPS HTTP server
LOCAL	No `TIMPS_URL`	Uses `@timps-ai/memory-core` MemoryEngine directly

45 MCP Tools

Core Memory

timps_chat, timps_get_memories, timps_store_memory

Contradiction Detection

timps_check_contradiction, timps_get_positions

Decision Intelligence

timps_check_regret, timps_log_decision, timps_simulate_decision, timps_log_past_decision

Burnout Monitoring

timps_burnout_analyze, timps_record_signal

Bug & Code Patterns

timps_warn_bug_pattern, timps_record_bug, timps_check_tech_debt, timps_record_incident

API Knowledge

timps_lookup_api, timps_record_api_quirk

Meetings & Commitments

timps_extract_commitments, timps_get_pending_commitments, timps_complete_commitment

Relationships

timps_record_mention, timps_relationship_check

Living Manifesto

timps_ingest_manifesto_signal, timps_get_manifesto

Chronos Veil (Causal Graph)

timps_chronos_ingest, timps_chronos_query, timps_chronos_stats

NexusForge (Knowledge Graph)

timps_nexus_ingest, timps_nexus_query, timps_nexus_stats, timps_nexus_graph

SynapseMetabolon

timps_synapse_ingest, timps_synapse_query, timps_synapse_stats, timps_synapse_graph, timps_synapse_consolidate

Architecture & Risk

timps_detect_architecture_drift, timps_predict_bug_risk, timps_get_incident_timeline, timps_check_deployment_risk

Developer Intelligence

timps_get_velocity_trend, timps_get_context_switches, timps_record_learning, timps_get_shared_decisions, timps_record_review_pattern

ChronosForge

timps_temporal_query, timps_chrono_foresight, timps_chrono_consolidate

L7+ Intelligence

timps_skill_shadow, timps_log_question, timps_curriculum_plan, timps_observe_culture, timps_codebase_culture, timps_record_contribution, timps_mark_contributor_active, timps_institutional_memory

22-Layer Tools

timps_verify_engram_chain, timps_false_memory_check, timps_explain_provenance, timps_resolve_conflict, timps_audit_memory, timps_register_trigger, timps_reveal_bias, timps_infer_schemas

Env Variables

Variable	Default	Description
`TIMPS_URL`	—	TIMPS server URL (SERVER mode)
`TIMPS_USER_ID`	`1`	User ID

Examples

You: "I'm going to use setTimeout for sync here"
→ timps_warn_bug_pattern → ⚠️ Bug pattern match (race condition, hit before in src/queue.ts)

You: "Remote teams don't work"
→ timps_check_contradiction → ⚠️ CONTRADICTION 82% — 47 days ago you said "Remote works best"

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

Read the getting-started guide

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.