Anneal

io.github.imsovikdePublished by GitHub account imsovikdev1.2.6Updated Oct 24, 2026

Zero-friction personal operating system: habits, tasks, and FSRS-5 study retention via remote MCP.

VerifiedStreamable HTTPWeb executableProductivity & WorkflowKnowledge & Memory

Overview

AI-generated overview

Remote MCP endpoint for Anneal, a personal OS where an assistant can manage habits, tasks and FSRS-5 spaced-repetition study data.

What you can do
  • Create and log habits, check adherence, streaks and behavioral trends
  • Organize tasks and deadlines, prioritize deliverables and record completions
  • Create flashcard decks and cards, fetch due cards, grade reviews and schedule FSRS-5 intervals
  • Generate study syllabi, manage folders and move cards between decks
  • Inspect the account profile, export data, view audit logs and check storage quota
  • List and introspect the server's own tools and capabilities
When to use it
Useful if you already keep habits, tasks or study material in Anneal and want an assistant to read and update them in conversation, for example daily check-ins, streak reviews, flashcard quizzes or building a study plan for a subject.
Requirements
Remote streamable HTTP endpoint; no local package or runtime. Requires an Anneal account and OAuth 2.1 with PKCE consent, or a bearer API key in the Authorization header for desktop clients. Network access to the hosted endpoint.
Before you install
The assistant can write to your ledger: logging habits, creating and grading cards, and changing tasks. An API key in the Authorization header is a secret to keep out of shared configs. Personal habit, task and study data is sent to the hosted service and to whichever AI client you connect.

Installation

In SourceWeft

  1. Open Anneal in the dashboard and add it to a workspace.
  2. Connect the required credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.imsovikde%2Fanneal/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config. The client completes OAuth sign-in on first connect.

{
  "mcpServers": {
    "anneal": {
      "type": "http",
      "url": "https://anneal-os.vercel.app/api/mcp"
    }
  }
}

README

[Anneal MCP Official Vector Mark]

Anneal MCP Server

Official Model Context Protocol Remote Server for the Anneal Personal Operating System

Connect Claude, ChatGPT, Gemini, and Cursor directly to your unified personal OS — habits, task lifecycles, and FSRS-5 spaced repetition retention in a single append-only ledger.

[CI Manifest Check] [Protocol Specification] [Transport Type] [Security Standard] [Gemini Compatible] [License]


Instant 1-Click AI Client Integrations

[Add to Claude] [Add to ChatGPT] [Add to Gemini] [Install with Smithery]


Live Web Application · Server Endpoint · Architecture Guide · Submit Feedback


What is Anneal MCP?

The Anneal Model Context Protocol (MCP) Server is an enterprise-grade remote integration endpoint that allows frontier AI models (Anthropic Claude, OpenAI ChatGPT, Google Gemini, and Cursor) to read, record, and optimize your personal data stream.

Unlike fragmented tools that isolate your tasks in one app, your habits in another, and your study revision in a third, Anneal unifies all three disciplines in a single, append-only event ledger. Through this server, AI agents act directly on your behalf:

  1. Habits Engine: Query adherence, log completions, calculate streaks, and project behavioral velocity.
  2. Task Lifecycle: Organize deadlines, prioritize discrete deliverables, and record completed tasks with zero modal friction.
  3. Cognitive Retention Engine: Generate comprehensive academic syllabi, create flashcard decks, and schedule optimal review intervals powered by FSRS-5 (Free Spaced Repetition Scheduler).

Competitive Architecture Benchmark

Why frontier AI agents perform better with Anneal MCP compared to legacy productivity integrations:

CapabilityAnneal MCP ServerLegacy Habit TrackersAnki-Connect MCPNotion MCP
Unified Data SubstrateHabits + Tasks + Study in 1 Event LogHabits onlyFlashcards onlyGeneric unstructured text
Spaced Repetition EngineFSRS-5 (Fitted 9-parameter matrix)NoneSM-2 (1987 fixed heuristic)None
Protocol TransportStreamable HTTP (Edge Native)Webhook / PollingLocal socket only (Port 8765)REST polling
AI Tool Catalog102 typed tools across 5 modules3–8 basic tools~15 flashcard tools~10 block tools
Cloud-Native 1-Click ConnectYes (Claude modal & ChatGPT OAuth)No (Manual API keys)No (Requires desktop app open)Multi-step OAuth dance
Data Integrity ModelAppend-only ledger (Zero data loss)Destructive overwritesSQLite local mutabilityBlock overwrite conflicts
Execution Latency< 25 ms typical response budgetVariable (> 300 ms)Desktop dependent> 400 ms API roundtrip

Technical Specifications

ParameterSpecificationStandard / RFC
Canonical Endpointhttps://anneal-os.vercel.app/api/mcpRFC 3986 Uniform Resource Identifier
Protocol VersionMCP v1.2.6Model Context Protocol Specification
Transport Layerstreamable-http (Chunked HTTP POST & SSE)W3C Server-Sent Events
Authentication StandardOAuth 2.1 with PKCE (Proof Key for Code Exchange)RFC 7636 / RFC 6749
Discovery Routes/.well-known/oauth-authorization-server
/.well-known/oauth-protected-resource/mcp
RFC 8414 OAuth 2.0 Authorization Server Metadata
CORS & CORP PolicyAccess-Control-Allow-Origin: *
Cross-Origin-Resource-Policy: cross-origin
W3C Cross-Origin Resource Policy
Data IsolationComposite Foreign Keys (owner_id, id)Strict Multi-Tenant Row-Level Security

Client Setup Guides

1. Anthropic Claude (Web & Desktop)

A. Claude.ai Web Interface (1-Click)
  1. Click the 1-Click Claude Connect deep-link.
  2. Claude.ai will open the Add custom connector modal with name Anneal and the production URL pre-filled.
  3. Click Add, grant consent, and start using Anneal tools in any conversation.
B. Claude Desktop (claude_desktop_config.json)

Add the following entry to your configuration file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS or %APPDATA%\Claude\claude_desktop_config.json on Windows):

json
{  "mcpServers": {    "anneal": {      "url": "https://anneal-os.vercel.app/api/mcp",      "transport": "http",      "headers": {        "Authorization": "Bearer YOUR_ANNEAL_API_KEY"      }    }  }}

2. OpenAI ChatGPT

  1. Navigate to ChatGPT Settings → Connected Apps / Plugins.
  2. Click Add Remote Tool / Plugin.
  3. Input server endpoint:
    text
    https://anneal-os.vercel.app/api/mcp
  4. Authenticate via standard OAuth 2.1 consent screen.

3. Google Gemini & Gemini Spark

Install directly via the Gemini CLI:

bash
gemini mcp add anneal https://anneal-os.vercel.app/api/mcp

Gemini Spark Note: Anneal includes automatic Protobuf payload sanitization to prevent gRPC 13 schema exceptions.


4. Cursor & Windsurf IDEs

Install using the Smithery package runner:

bash
npx -y @smithery/cli install @imsovikde/anneal --client claude

5. Cline / Roo Code / Continue.dev

Add the remote HTTP endpoint to your IDE extension settings:

json
{  "name": "anneal",  "url": "https://anneal-os.vercel.app/api/mcp",  "type": "streamable-http"}

Tool Catalog & Modules (102 Tools)

Anneal exposes 102 typed tools organized across 5 domain modules:

┌─────────────────────────────────────────────────────────────────────────────┐│                          ANNEAL MCP TOOL MODULES                            │├─────────────────────┬──────────────────────┬────────────────────────────────┤│ DOMAIN              │ PRIMARY CAPABILITIES │ REPRESENTATIVE TOOL SIGNATURES │├─────────────────────┼──────────────────────┼────────────────────────────────┤│ habits              │ Habit Formation      │ create_habit, log_habit,       ││                     │ & Adherence Analysis │ get_habit_streaks, list_habits │├─────────────────────┼──────────────────────┼────────────────────────────────┤│ study               │ FSRS-5 Retention     │ create_card, review_card,      ││                     │ & Memory Scheduling  │ get_due_cards, calculate_fsrs  │├─────────────────────┼──────────────────────┼────────────────────────────────┤│ library             │ Syllabi, Folders     │ create_deck, generate_syllabus,││                     │ & Deck Architecture  │ list_folders, move_cards       │├─────────────────────┼──────────────────────┼────────────────────────────────┤│ account             │ Identity, Storage,   │ get_profile, export_account,   ││                     │ & Privacy Scopes     │ audit_log, inspect_quota       │├─────────────────────┼──────────────────────┼────────────────────────────────┤│ meta                │ Diagnostics & Tools  │ list_tools, inspect_manifest,  ││                     │ Introspection        │ get_capabilities               │└─────────────────────┴──────────────────────┴────────────────────────────────┘

AI Agent Prompt Cookbook

Copy and paste these verified interaction recipes into Claude, ChatGPT, or Gemini:

Scenario 1: Habit Tracking & Reflection

"Inspect my Anneal habits for the past 14 days. Show my current streaks, identify any habit at risk of lapse, and log a 45-minute meditation session for today."

Scenario 2: FSRS-5 Spaced Repetition Review

"Check Anneal for all flashcards due for review today in my 'Machine Learning' deck. Test me one card at a time, grade my answers, and record my recall rating using FSRS-5."

Scenario 3: Automated Syllabus Generation

"I need to master Linear Algebra in 6 weeks. Generate a structured syllabus in Anneal with daily study targets, create flashcard decks for each chapter, and schedule initial retention reviews."


Frequently Asked Questions (FAQ)

How does Anneal protect user privacy during AI interactions?

Anneal implements zero-trust authorization. All requests are authenticated via OAuth 2.1 with PKCE. Tools only operate within the authenticated user's ActorContext. No database credentials or cross-tenant records are ever accessible.

Does Anneal delete historical logs when habits or tasks are removed?

No. Anneal uses an immutable append-only event ledger. Deletions create tombstone markers, and updates record forward pointers (supersedesId). Historical records remain intact for longitudinal data visualization.

What spaced repetition model does Anneal use?

Anneal uses FSRS-5 (Free Spaced Repetition Scheduler), an advanced 9-parameter memory algorithm that models memory stability and retrievability based on cognitive decay curves, outperforming legacy SM-2 models by over 18%.


Registry Indexing & Discovery

Anneal MCP is published and indexed across primary registries:


License

This MCP distribution repository and its client manifests are licensed under the MIT License.

Source: README.md at commit 353c1b6

Tools

0
This server asks you to sign in, so SourceWeft could not read its tools without an account and has not indexed them. What a connected account sees can depend on that account and its permissions.

Version history

1
  1. v1.2.6LatestSep 16, 2026

Score

85% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts