TimeTree-MCP CLAUDE.md

TimeTree-MCP CLAUDE.md is an instructions file for coding agents from ehs208/TimeTree-MCP. It costs 1,246 tokens per session, scanned A, original, MIT.

Project guidance for TimeTree MCP, an unofficial server that connects MCP-compatible clients to TimeTree calendar data through its web APIs.

In plain words
What is it for?
Use it when listing calendars, reading or changing events, managing event comments and memos, or maintaining the server without exposing session data.
Why use it?
It explains the project's supported calendar actions and its limits, including that TimeTree does not officially support or endorse it and its API connection may change.

Instructions file

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/ehs208/timetree-mcp/claude-md
Clone the repo
git clone --depth 1 https://github.com/ehs208/TimeTree-MCP

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for TimeTree-MCP CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/ehs208/timetree-mcp/claude-md.svg)](https://agentmods.dev/instructions/ehs208/timetree-mcp/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/ehs208/timetree-mcp/claude-md"><img src="https://agentmods.dev/badge/instructions/ehs208/timetree-mcp/claude-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 1,246 This file is loaded in full into every session.
When invoked 1,246 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.01246 $0.01246
Opus 5 $0.00623 $0.00623
Sonnet 5 $0.00249 $0.00249
Haiku 4.5 $0.00125 $0.00125

Measured 4d ago against content hash 756c931cca77, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

TimeTree-MCP CLAUDE.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

CLAUDE.md · 122 lines

How it starts

The opening of the file, as written. The whole thing — 122 lines — stays where its author put it; the contents beside it link to each section on GitHub.

TimeTree MCP Project Guide

This is the shared project guide for people and AI coding assistants working in this repository. Keep it safe to commit: add only project-level guidance, never personal preferences, local machine paths, private credentials, copied calendar data, or session artifacts.

Project Purpose

TimeTree MCP is an unofficial Model Context Protocol (MCP) server for TimeTree. It connects MCP-compatible clients to TimeTree calendar data through TimeTree web APIs.

Important context:

  • This project is not affiliated with, endorsed by, or supported by TimeTree.
  • The API behavior is based on observed TimeTree web app behavior and may change without notice.
  • package.json must keep "private": true unless maintainers explicitly decide to publish.
  • Do not publish this package to npm or an MCP marketplace without maintainer approval.
  • Treat upstream endpoints, cookies, CSRF tokens, and session identifiers as implementation details.

Current Capabilities

The server currently exposes tools for:

  • Listing calendars.
  • Reading calendar events and updated events.
  • Creating, updating, and deleting events.
  • Managing event comments.
  • Listing and managing memos.
  • Reading and updating calendar labels.
  • Reading calendar members and virtual members.

Write operations depend on TimeTree web authentication and CSRF handling. Keep error messages clear, but do not expose internal auth material.

Architecture Map

  • src/index.ts - MCP server entry point and request routing.
  • src/config/config.ts - TimeTree constants, API paths, and client metadata.
  • src/client/auth.ts - Email/password authentication, CSRF extraction, and session state coordination.
  • src/client/api.ts - TimeTree HTTP client operations, pagination, and domain-specific API methods.
  • src/tools/ - MCP tool definitions and input/output shaping.
  • src/types/ - Zod schemas and shared TimeTree types.
  • src/utils/http-client.ts - HTTP wrapper, headers, cookies, and CSRF token handling.
  • src/utils/logger.ts - Structured logging and sensitive-data masking.
  • src/utils/rate-limiter.ts - Token-bucket request throttling.

Read the full file on GitHub · 122 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 4d ago First seen · 122 lines · 1,246 tokens per session scan A 756c931cca77

Subscribe to this mod's changes

TimeTree-MCP CLAUDE.md is an instructions file published in the GitHub repository ehs208/TimeTree-MCP (14 stars, last pushed 3d ago), licensed MIT. It adds 1,246 tokens to every session, about $0.0062 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other instructions, from other repositories

mcp-server-apple-events CLAUDE.md

Claude Code instructions for FradSer/mcp-server-apple-events, covering claude.md, commands, run all tests, run a single test file and run tests matching a pattern.

FradSer/mcp-server-apple-events · 2,137 tokens

mcp-server-apple-events AGENTS.md

AGENTS.md instructions for FradSer/mcp-server-apple-events, covering repository guidelines, project structure & module organization, build, test, and development commands, coding style & naming conventions and testing guidelines.

FradSer/mcp-server-apple-events · 839 tokens

mcp-server-apple-events GEMINI.md

Gemini CLI instructions for FradSer/mcp-server-apple-events, covering apple events mcp server, project overview, architecture, building and running and prerequisites.

FradSer/mcp-server-apple-events · 1,136 tokens

webmcp-react AGENTS.md

AGENTS.md instructions for agentcathq/webmcp-react, covering agents.md, reference, commands, project structure and architecture decisions — don't "fix" these.

agentcathq/webmcp-react · 1,648 tokens

prism-coder GEMINI.md

Gemini CLI instructions for dcostenco/prism-coder: See the Synalux engineering standards doc for the full protocol. This file inherits those standards. Additional Prism-specific rules.

dcostenco/prism-coder · 101 tokens

fireflyiii-mcp AGENTS.md

AGENTS.md instructions for daften/fireflyiii-mcp, covering mcp server for firefly iii — project documentation, project overview, architecture at a glance, tech stack and environment variables.

daften/fireflyiii-mcp · 8,846 tokens