Skip to main content
Glama
Notecase

@noteshell/mcp

by Notecase
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

@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.

Related MCP server: obsidian-mcp-complete

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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • mcp-apple-notes

    Dan8Oren
    A
    license
    A
    quality
    C
    maintenance
    MCP server for Apple Notes with semantic search (on-device embeddings via all-MiniLM-L6-v2), full-text search, complete CRUD operations, folder management, and fuzzy title matching. 10 tools. Runs fully locally on macOS — no API keys required.
    10
    10 npm
    13
    MIT

  • obsidian-mcp-complete

    jagoff
    A
    license
    B
    quality
    D
    maintenance
    Local-first MCP server for Obsidian vaults with 66 tools for reading, writing, searching, and managing notes, tasks, graphs, and more. Works without Obsidian running and requires no plugins.
    66
    MIT

  • Bruin

    sawzhang
    A
    license
    Not graded
    quality
    C
    maintenance
    MCP server for AI agents to read, write, and organize notes in a local-first, human-in-the-loop note-taking app.
    0
    2
    MIT

  • kips

    hdresearch
    A
    license
    Not graded
    quality
    D
    maintenance
    Personal data management MCP server that stores and queries notes, tasks, conversations, and auth in SQLite, enabling LLMs to interact with the database through natural language.
    8 npm
    5
    ISC