Noteshell

Your personal knowledge base and productivity system — notes, study plans, daily tasks, and learning analytics, all accessible through MCP tools.

MCP Prerequisite

Before using any workflow, verify the Noteshell MCP server is connected. Try calling:

secretary_today

If the tool is not available, the user needs to set up the MCP server:

# 1. Authenticate (opens browser)
npx @noteshell/mcp login

# 2. Add to Claude Code (~/.claude.json or .mcp.json)
{
  "mcpServers": {
    "noteshell": {
      "command": "npx",
      "args": ["-y", "@noteshell/mcp"]
    }
  }
}

# 3. Restart Claude Code

Once the MCP tools are available, proceed with the workflows below.

Tool Quick Reference (43 tools)

Common Patterns

Read Before Write

Always read the current state before writing:

1. secretary_today → see current plan
2. secretary_task_modify → update a task

Project-Scoped Operations

Most note tools accept project_id for filtering:

1. projects_list → find project UUID
2. notes_list { project_id: "..." } → list notes in project

Memory File Naming

• Root files: AI.md, Plan.md, Today.md, Tomorrow.md, Recurring.md, Calendar.md
• Plans: Plans/<name>.md (e.g. Plans/algo-roadmap.md)
• History: History/YYYY-MM-DD.md (auto-archived daily plans)

Task Markers

• [ ] pending, [x] done, [>] carried over, [-] skipped

Quick Recipes

"What am I working on?"

secretary_today         → today's plan
secretary_plans_list    → active roadmaps
context_entries         → recent activity across agents

"Plan tomorrow"

secretary_preferences      → study hours, break frequency
secretary_plans_list       → active plans + schedule
secretary_recurring_manage → recurring blocks
secretary_daily_generate { target: "Tomorrow.md", content: "..." }

"Find something"

search_global { query: "..." } → search notes + memory
notes_get { note_id: "..." }   → read full content

"How am I doing?"

secretary_analytics → completion rates, streaks, mood trends
soul_read           → goals and preferences

Full Methodology

For detailed step-by-step workflows (morning routine, evening reflection, weekly review, study planning, note organization, research capture, daily workflow), fetch the full guide:

MUST MANDATORY Fetch fresh guidelines below:

https://raw.githubusercontent.com/Notecase/noteshell-mcp/main/skills/noteshell/NOTESHELL.md

Follow the instructions in NOTESHELL.md for the workflow that matches the user's request.