@noteshell/mcp

Noteshell MCP Server — Access your notes, tasks, and learning plans from Claude Code and any MCP-compatible client. 43 pure-data tools, zero AI calls, 2-minute setup.

What is Noteshell?

Noteshell is an agent-first learning OS for students, researchers, and lifelong learners. Your notes, study plans, daily tasks, and knowledge base — all accessible to your AI assistant through this MCP server.

Setup (2 steps)

1. Authenticate

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

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

This logs you into Noteshell and saves your credentials to ~/.noteshell.json. You need a Noteshell account.

2. Add to your AI coding tool

Add to your ~/.claude.json, .mcp.json, or equivalent MCP config:

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

Reload your AI coding tool — done. Works with Claude Code, Cursor, Codex CLI, and any MCP-compatible client.

---

Available Tools (43 total)

Prefix	Count	What it does
notes_*	13	Create, read, update, search, organize notes
projects_*	1	List your projects/folders
secretary_*	20	Daily tasks, study plans, memory files, analytics
context_* / soul_*	5	Cross-agent context bus, user goals & preferences
calendar_*	3	Calendar events
search_*	2	Full-text search across notes and memory

---

Skills

Noteshell ships with 7 methodology skills — step-by-step workflows that teach your AI agent how to use the tools effectively:

Skill	Purpose
Morning Routine	Review yesterday, archive, pick focus, generate plan
Evening Reflection	Capture mood, carry over tasks, prepare tomorrow
Weekly Review	7-day analytics, plan progress, mood trends
Study Planning	Create roadmaps, break down subjects, track progress
Note Organization	Structure projects, enrich notes, task-to-note pattern
Research to Notes	Capture research findings as structured knowledge
Daily Workflow	Activity logging, quick task updates during the day

Once the MCP server is running, just talk to your AI agent naturally:

• "Plan my day"
• "What have I been working on?"
• "Create a study plan for algorithms"
• "How am I doing this week?"

---

How it works

Claude Code / Cursor / Codex CLI
        │
        ▼
@noteshell/mcp  (this package — data only, no AI)
        │
        ▼
Your Noteshell data (cloud, secured by your account)

No AI runs inside the MCP server. Claude does the thinking; Noteshell provides the data.

---

Skill (Methodology Workflows)

For structured workflows (morning routine, evening reflection, weekly review, study planning), install the companion skill:

npx skills add Notecase/noteshell-mcp

This teaches your AI agent how to use the MCP tools effectively — slash commands like /plan-my-day, /morning-routine, /evening-reflection, /weekly-review.

---

License

MIT