Skip to content

Tools Overview

Per-section reference for every built-in tool dispatched by Claude Code.

  1. How tools work
  2. Filesystem tools
  3. Shell & code execution tools
  4. Network & web tools
  5. Orchestration & agent tools
  6. Scheduling & tasks
  7. Session & user interaction tools
  8. MCP (Model Context Protocol) tools
  9. Meta & search tools
  10. Remote & entrypoint-specific tools
  11. Tools present in source but not in public docs
  12. Feature-flag-gated tools summary
  13. Discrepancies & notes
  14. MCP tools — dynamic registration
  15. Permissions & tool access control
  16. Related references

16 sections, 44 entries across tool catalog, narrative, and reference subsections.

#SectionDescriptionEntries
1How tools workHow Claude dispatches tool calls, permissions, entrypoint gating, and MCP vs built-in distinction.0
2Filesystem toolsRead, Write, Edit, NotebookEdit, Glob, Grep — the file I/O and search primitives.6
3Shell & code execution toolsBash, PowerShell, LSP, Monitor — running commands and interacting with code intelligence.4
4Network & web toolsWebFetch and WebSearch for retrieving external content.2
5Orchestration & agent toolsAgent, Skill, SendMessage, TeamCreate/Delete — spawning and coordinating sub-agents.5
6Scheduling & tasksCronCreate/Delete/List plus TodoWrite and the Task* family for work tracking and cron-style scheduling.10
7Session & user interaction toolsEnterPlanMode, ExitPlanMode, EnterWorktree, ExitWorktree, AskUserQuestion, Config — session-state primitives.6
8MCP (Model Context Protocol) toolsListMcpResources and ReadMcpResource — primitives for reading MCP server resources.2
9Meta & search toolsToolSearch, BriefTool, SleepTool — meta operations on the tool catalog itself.3
10Remote & entrypoint-specific toolsRemoteTrigger and other tools available only in specific entrypoints (SDK, remote).1
11Tools present in source but not in public docsInternal / experimental tools from the source tree that aren’t on the public tools-reference page.5
12Feature-flag-gated tools summaryTools gated by ENV-level feature flags, mapped to their enabling env vars.0
13Discrepancies & notesKnown mismatches between public docs, source snapshot, and runtime behavior.0
14MCP tools — dynamic registrationHow MCP servers register tools dynamically as mcp__<server>__<tool>.0
15Permissions & tool access controlAllow/ask/deny rules, the permission model, and per-tool gating via settings.json.0
16Related referencesCross-links to other docs in this repo (Commands, Skills, ENV, Settings).0
ToolClassSide effectGatingPurpose
ReadFilesystemRead-onlyAlwaysRead file contents, including images and notebooks
WriteFilesystemWritesPermissionCreate or overwrite files
EditFilesystemWritesPermissionMake targeted edits to specific lines
NotebookEditFilesystemWritesPermissionModify Jupyter notebook cells
GlobFilesystemRead-onlyAlwaysFind files by glob pattern matching
GrepFilesystemRead-onlyAlwaysSearch for patterns in file contents
BashShellExecutesPermissionRun shell commands (POSIX/Bash)
PowerShellShellExecutesPermissionRun PowerShell commands (opt-in)
LSPCode intelligenceRead-onlyAlwaysJump to definitions, find references, type info
WebFetchNetworkRead-onlyPermissionFetch and parse content from URLs
WebSearchNetworkRead-onlyPermissionPerform web searches (US only)
AgentOrchestrationSpawnsAlwaysSpawn a subagent with isolated context
SkillOrchestrationSpawnsPermissionExecute a skill from the skill registry
CronCreateSchedulingSpawnsAlwaysSchedule a one-time or recurring prompt
CronDeleteSchedulingSpawnsAlwaysCancel a scheduled task
CronListSchedulingRead-onlyAlwaysList all scheduled tasks
TaskCreateTask managementSpawnsAlwaysCreate a task in the task list
TaskGetTask managementRead-onlyAlwaysGet details for a specific task
TaskListTask managementRead-onlyAlwaysList all tasks with status
TaskUpdateTask managementWritesAlwaysUpdate task status, details, or delete
TaskStopTask managementExecutesAlwaysKill a running background task
TaskOutputTask managementRead-onlyAlways(Deprecated) Get output from a background task
EnterPlanModeSessionNoneAlwaysSwitch to plan mode (design before code)
ExitPlanModeSessionWritesPermissionPresent plan and exit plan mode
EnterWorktreeSessionSpawnsAlwaysCreate or switch to a git worktree
ExitWorktreeSessionNoneAlwaysExit a worktree and return to main
MonitorShellExecutesPermissionRun command in background, feed output back
SendMessageOrchestrationNoneAlwaysMessage a teammate or resume a subagent
TeamCreateOrchestrationSpawnsFeature-flagCreate an agent team with multiple teammates
TeamDeleteOrchestrationExecutesFeature-flagDisband a team and clean up resources
AskUserQuestionSessionNoneAlwaysAsk multiple-choice questions
ConfigSessionWritesAlwaysGet or modify settings
ToolSearchMetaRead-onlyFeature-flagSearch for and load deferred tools
ListMcpResourcesMCPRead-onlyAlwaysList resources exposed by MCP servers
ReadMcpResourceMCPRead-onlyAlwaysRead a specific MCP resource by URI
TodoWriteTask managementWritesAlwaysManage session task checklist (non-interactive)
RemoteTriggerRemoteExecutesEntrypointTrigger a remote session or API call
BriefToolSessionNoneFeature-flagEnable brief/compact output mode
SleepToolMetaNoneInternalSleep for a duration (testing/internal)