Noteshell MCP Server

Your Inkdown knowledge base as MCP tools. Notes, secretary planner, cross-agent context — all accessible from any MCP-compatible client.

Quick Reference

Tool Groups

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)

Quick Recipes

📋 "What am I working on?"

1. secretary_today         → today's plan
2. secretary_plans_list    → active roadmaps
3. context_entries         → recent activity across agents

📝 "Create a note from research"

1. projects_list                              → find target project
2. notes_create { title, content, project_id } → create the note
3. context_write { type: "note_created" }      → log in context bus

🗓️ "Plan tomorrow"

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

🔍 "Find something"

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

📊 "How am I doing?"

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

Methodology Skills

For deeper workflows, see the specialized skill files:

Configuration

Setup (run once)

# Recommended: browser-based login
npx @noteshell/mcp login

# Legacy alternative: email/password
npx @noteshell/mcp setup <email> <password>

Writes ~/.noteshell.json automatically. Requires a Noteshell account at noteshell.app.

Claude Code MCP config

{
  "mcpServers": {
    "noteshell": {
      "command": "npx",
      "args": ["-y", "@noteshell/mcp"]
    }
  }
}