About Note Taker MCP
Note Taker MCP is an MCP server published by chriskyle in the Developer Tools category: allow the model to write scratch notes during reasoning phases for more reliable detail surfacing in long context tasks.
The repository has 2 stars and 0 forks, with the last commit 5 months ago. Recent commit activity is the strongest signal that reported issues will get attention.
Install
git clone https://github.com/chriskyle/note-takerThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Note Taker MCP
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 7 days ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- !License declaredNo license file. Legally you have no right to use it in a product.
- ✓Tests presentA test suite exists in the repository.
- !Dependencies pinnedNo lockfile. Installs can pull different code over time.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
1 check has not been run yet.
README
Note Taker Skill
note-taker is a Codex skill for temporary, session-scoped working notes. It is designed for long or multi-step agent tasks where intermediate facts, decisions, files, and TODOs need to survive across turns or compaction without becoming durable cross-run memory.
The runtime artifact is the skill directory:
skill/
SKILL.md
scripts/
notes.py
There is no MCP server, package installation, vector store, or runtime dependency.
Design
The skill resolves a deterministic temp session from:
NOTE_TAKER_SESSION_ID, if set.CODEX_THREAD_ID, if set.- Otherwise it fails loudly and asks for
NOTE_TAKER_SESSION_ID.
The session key is a hash of:
session identity + workspace root + git branch/ref
By default, session files live under:
/tmp/note-taker/v1/sessions/<session-key>/
MANIFEST.json
NOTES.md
TODO.md
This gives the intended lifetime:
- same thread, repo, and branch: same temp notes across turns
- new thread: new notes
- new branch/ref: new notes
- missing session identity: no fuzzy reuse
MANIFEST.json is script-owned metadata. The model-facing files are:
NOTES.md: mutable working understanding, findings, decisions, relevant files, open questions, and corrected assumptions.TODO.md: mutable task tracking with current, blocked, and done sections.
Usage
Run the bundled script directly:
python skill/scripts/notes.py resume
Useful commands:
python skill/scripts/notes.py init
python skill/scripts/notes.py where
python skill/scripts/notes.py resume
python skill/scripts/notes.py search "query"
python skill/scripts/notes.py gc
Use NOTE_TAKER_ROOT or --root to override the temp base directory.
Installing As A Codex Skill
Copy skill/ into your Codex skills directory as note-taker. The skill instructions in skill/SKILL.md describe when and how the agent should use the bundled script.
Development
This repo keeps pyproject.toml only for development tooling. It is not a Python package and is not intended for PyPI distribution.
python3 -m venv .venv
.venv/bin/python -m pip install pytest ruff
.venv/bin/python -m pytest
.venv/bin/python -m ruff check .
README fetched from the repository 7 days ago. The original is authoritative.