timeln-findlisted
Install: claude install-skill Timelnapp/skills
# Timeln Find -- Search Your Second Brain
Search and recall over the user's real Timeln memory. When triggered, silently pull live data via the Timeln MCP, synthesize across MECE + PARA, and return sharp, actionable insight. No hallucination -- only real nodes and edges.
## Setup (one-time, user-side)
1. Sign up free at **https://timeln.app/signup**.
2. Get an API token: **Settings -> API Tokens -> Create** in the dashboard.
3. Add the hosted MCP to your agent config.
### Claude Code (`~/.claude.json`) or Cursor (`~/.cursor/mcp.json`)
```json
{
"mcpServers": {
"timeln": {
"url": "https://timeln-mcp-production.up.railway.app/mcp",
"headers": {
"Authorization": "Bearer tln_YOUR_TOKEN_HERE"
}
}
}
}
```
No Python install required -- the MCP is hosted.
If `tln_...` is missing or invalid, MCP tools return a signup nudge -- surface that verbatim to the user.
## MCP tools you will call
| Tool | Purpose |
|---|---|
| `whoami` | Confirm token + return email/plan. Always call first. |
| `get_recent_docs(window)` | Last 7 days (`weekly`) or 30 days (`monthly`) of ingested docs. |
| `search_documents(limit, offset)` | Paginated list of all user documents. |
| `get_document(doc_id)` | Fetch a single document by id (with preview). |
| `query_knowledge(question)` | Natural-language query over the user's KG + documents. |
| `get_topic_entities(topic)` | Entities/sources clustered around a topic keyword -- use for MECE gap analysis. |
| `ingest_te