Skip to content
Agentmart
Submit a tool

Everkeep

Your notes in one folder on your own server; AI clients read and edit it under write policies

Connector by st412m · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)★ 2
Write a review

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/st412m-everkeep

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

Your notes in one folder on your own server; AI clients read and edit it under write policies

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools
12 read · 4 write · 0 delete · 4 not yet classified
Secrets
None asked for
Install scripts
None found
Runs as
Node.js package

Tools by what they do 20

Read from the source code; the running server may list different tools.

Read 12 · Look things up without changing anything.

  • get_file_info
  • grep_files
  • list_allowed_directories
  • list_directory
  • list_directory_with_sizes
  • read_file
  • read_media_file
  • read_multiple_files
  • read_pdf_page
  • read_text_file
  • search_files
  • sqlite_schema

Write 4 · Create, change, send or run things.

  • create_directory
  • edit_file
  • move_file
  • write_file

Not yet classified 4 · We could not tell from the name and description.

  • directory_tree
  • read_pdf_text
  • sqlite_query
  • trash_file

Secrets and settings it asks for

Other settings (environment variables or headers).

  • EVERKEEP_CONFIG
  • EVERKEEP_VAULT

Network hosts it talks to 2

  • github.com · found in code
  • glama.ai · found in code

Files it touches

  • /etc/passwd
  • /home/me/notes
  • /srv/notes
  • /srv/notes_old
  • %APPDATA%\\Claude\\
  • %APPDATA%\\Claude\\logs
  • Your home directory (~)
  • ~/.config/everkeep/config.json
  • ~/.config/systemd/user/everkeep.service
  • ~/.cursor/mcp.json
  • ~/Library/Logs/Claude
  • Any path the agent passes to its tools

Tools (20)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • create_directory

    Create a directory (and parents); an existing one is not an error. Refused where the zone policy forbids writing.

  • directory_tree

    Recursive tree view, 2 levels deep. One level: list_directory.

  • edit_file

    Edit a file. Two mutually exclusive edit shapes: {oldText,newText} literal replacement, or line edits (1-based). {startLine,endLine,newText} replaces the inclusive range; newText "" deletes, no trailing newline. Omitting endLine INSERTS before startLine instead of replacing, and startLine = lines+1 appends at EOF. Line edits require rev and are applied bottom-up in one atomic pass, so numbers from a single grep/read stay valid; a stale rev is rejected, never applied. Returns the new rev. dryRun shows the diff. In a zone with policy overwrite="rev" every edit needs rev, including {oldText}; in …

  • get_file_info

    Metadata for a file or directory: size, times, format, plus line count and rev for text files (the rev that writes in a strict zone ask for). Content: read_text_file.

  • grep_files

    Search file CONTENTS by regex, recursively. Per file returns path, rev, line count, then matching line numbers with their text. Long lines are clipped around the match (max_line_length, default 200). Line numbers and rev feed straight into read_text_file offset/limit and edit_file line edits. Documents (PDF, Word, spreadsheets…) are searched in their extracted text: matches as L<n> (p.N / slide N / sheet Name), no rev; documents:false skips them. Other binaries and symlinks are skipped; output is capped and flags truncation when incomplete. To find files by name use search_files.

  • list_allowed_directories

    The vault root; every path must be inside it. Start here if the vault path is unknown.

  • list_directory

    List one directory; the first line is the policy in force. Sizes: list_directory_with_sizes; deeper levels: directory_tree.

  • list_directory_with_sizes

    List a directory with file sizes, sorted by name or size. Without sizes: list_directory.

  • move_file

    Move or rename a file or directory. Taking a file out of a zone with policy overwrite="rev" requires its current rev, exactly like overwriting it in place; directories are not moved out of a strict zone at all. Use trash_file, not this, to discard something; moving a file out of the trash restores it.

  • read_file

    DEPRECATED alias of read_text_file.

  • read_media_file

    Read an image, audio or PDF file. PDF returns one page (default 1, or "#N" path suffix) as JPEG plus the total page count. For PDF text use read_pdf_text; one PDF page as an image: read_pdf_page.

  • read_multiple_files

    Read several whole files at once (documents as numbered lines, as read_text_file; the trash is skipped). For a line range or rev use read_text_file.

  • read_pdf_page

    Render one PDF page (1-based) as JPEG. Prefer read_pdf_text unless layout or graphics matter.

  • read_pdf_text

    Text of a PDF, whole or a page range, as numbered lines with page markers (the same numbers as read_text_file). Much cheaper than page images — prefer it; for scans use read_pdf_page.

  • read_text_file

    Read one file. Whole file by default; head/tail = N lines from an edge; offset/limit = an arbitrary 1-based line range, which also reports total lines and rev (needed for edit_file line edits). Documents (PDF, DOCX, XLSX, PPTX, ODF, EPUB, MSG…) come as numbered lines with section markers, no rev, read-only; HTML, RTF, EML and FB2 read raw, extract:true gives their text. Several files at once: read_multiple_files; images and page images: read_media_file / read_pdf_page.

Show 5 more tools
  • search_files

    Find files by NAME substring, recursively. For content use grep_files.

  • sqlite_query

    Run one read-only SQL statement on a SQLite file (sqlite3 -readonly -safe -json; ATTACH and other escapes are disabled). Must start with SELECT, WITH, VALUES, or EXPLAIN [QUERY PLAN] followed by one of those. Runs wrapped as SELECT * FROM (<sql>) LIMIT <limit+1>; truncated=true means more rows exist. ";" is allowed only inside string literals, quoted identifiers and comments, plus one trailing. Bind parameters (?, :x, @x, $x, #x) are rejected — write values as literals. EXPLAIN describes the wrapped statement. BLOBs are not converted — use hex(col) or length(col). A database with a -wal journa…

  • sqlite_schema

    Inspect a SQLite database file: schema-neutral, no interpretation of the data. File type is decided by the first 16 bytes, not the extension. Returns table/index/view/trigger DDL from sqlite_master, the journal_mode/page_size/page_count/encoding/user_version/application_id PRAGMAs, the sqlite3 version, whether -wal/-shm siblings exist next to the ORIGINAL file, plus path/size/mtime (UTC and local with numeric offset). A database with no journal (or an empty leftover one) is opened in place and leaves no new files behind; one with a real -wal is read from a private copy instead, cleaned up afte…

  • trash_file

    Discard a file by moving it into the trash of its own zone, keeping its relative path and adding an arrival timestamp to the name. There is no delete: this is the only way to remove something. Fails if the zone has no trash configured. In a zone with overwrite="rev" the current rev is required — you have to read a file before throwing it away. To restore, move_file it back out of the trash.

  • write_file

    Create or overwrite a file with given content. In a zone with policy overwrite="rev", overwriting an EXISTING file requires its current rev (creating a new one does not); the refusal message carries the rev to use. For a change inside a file use edit_file. Document formats (PDF, DOCX…) are not overwritten.

Signals

Stars
2
Forks
0
Open issues
0
Last commit
Oct 15, 2026 (13 days ago)
Last release
Oct 14, 2026 (14 days ago)

From GitHub (fetched Oct 24, 2026).

Details

Registry name
io.github.st412m/everkeep
Version
1.0.0
Auth
No auth
Packages
npm everkeep
License
MIT
Repository
github.com/st412m/everkeep
First seen
Oct 24, 2026
Last checked
Oct 24, 2026
Source
Official MCP Registrygithub-graphql

More from st412m

Cite this page

Everkeep MCP server. Agent Mart. https://agentmart.dev/connectors/st412m-everkeep (last updated 2026-10-24)