io.github.Tom-R-Main/mcp-server

Official

by execufunction-mcp · JavaScript

ExecuFunction

AI executive function assistant — tasks, calendar, knowledge, code indexing, and CRM for your IDE.

IDE-integrated assistant for tasks, calendar, knowledge, code indexing, and CRM.

README.md10 KBView on GitHub

ExecuFunction MCP Server

A Model Context Protocol server that exposes ExecuFunction tools to IDE clients like Cursor, Claude Desktop, and VS Code.

Quick Start

1. Create a Personal Access Token

Go to ExecuFunction → Settings → Developer → Access Tokens
Click "Create Token"
Name it (e.g., "Cursor MCP")
Select scopes: mcp:* (or specific scopes like projects:read, tasks:write)
Save the token immediately - it's only shown once!

2. Configure Your MCP Client

Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

json

{
  "mcpServers": {
    "execufunction": {
      "command": "npx",
      "args": ["@execufunction/mcp-server"],
      "env": {
        "EXF_API_URL": "https://execufunction.com",
        "EXF_PAT": "exf_pat_your_token_here"
      }
    }
  }
}

Cursor

Add to your Cursor MCP settings:

json

{
  "execufunction": {
    "command": "npx",
    "args": ["@execufunction/mcp-server"],
    "env": {
      "EXF_API_URL": "https://execufunction.com",
      "EXF_PAT": "exf_pat_your_token_here"
    }
  }
}

VS Code

Configure in your MCP extension settings.

3. Restart Your IDE

After configuration, restart your IDE to load the MCP server.

Available Tools

Projects

Tool	Description	Mutates
`project_list`	List all projects with status filtering	No
`project_create`	Create a new project	Yes
`project_update`	Update project name, summary, status, emoji	Yes
`project_archive`	Archive a project (destructive)	Yes
`project_get_context`	Get full project context (tasks, notes, signals)	No

Tasks

Tool	Description	Mutates
`task_list`	List tasks with project/status/phase/effort filters	No
`task_get`	Get a single task with full details	No
`task_create`	Create a new task with priority, phase, effort, acceptance criteria	Yes
`task_update`	Update task fields (title, status, priority, phase, effort, scope)	Yes
`task_delete`	Delete a task (destructive)	Yes
`task_complete`	Mark a task as complete	Yes
`task_link_code`	Link a task to a code file/commit	Yes

Knowledge / Notes

Tool	Description	Mutates
`note_list`	List notes with type and project filters	No
`note_get`	Get a single note with full content	No
`note_search`	Semantic search across knowledge base	No
`note_create`	Create a new note (markdown)	Yes
`note_update`	Update note title, content, or type	Yes
`note_delete`	Delete a note (destructive)	Yes

People

Tool	Description	Mutates
`people_search`	Search contacts	No

Calendar

Tool	Description	Mutates
`calendar_list_events`	List calendar events for a date range	No
`calendar_create_event`	Create a new calendar event	Yes
`calendar_update_event`	Update a calendar event	Yes
`calendar_delete_event`	Delete a calendar event (destructive)	Yes

Codebase Indexing

Tool	Description	Mutates
`codebase_list`	List indexed repositories	No
`codebase_register`	Register a new repository for indexing	Yes
`codebase_status`	Check indexing status and stats	No
`codebase_snapshot_status`	Get latest index snapshot for a repository	No
`codebase_materialize_snapshot`	Download a snapshot archive	No
`codebase_index`	Full index: scan and upload all files	Yes
`codebase_index_incremental`	Incremental index: git-aware, changed files only	Yes
`codebase_delete`	Delete a repository and all indexed data (destructive)	Yes
`codebase_search`	Semantic search across indexed code	No

Code History & Expertise

Tool	Description	Mutates
`code_who_knows`	Find experts for a code area	No
`code_compute_expertise`	Refresh the expertise index	Yes
`code_history`	Get commit history for a repository	No
`git_blame_symbol`	Run git blame on a local file range	No

Code Memories

Tool	Description	Mutates
`code_memory_store`	Store a fact about the codebase	Yes
`code_memory_search`	Search stored code facts	No
`code_memory_list`	List all stored code memories	No
`code_memory_delete`	Delete a code memory (destructive)	Yes

Vault / Secrets

Tool	Description	Mutates
`vault_list`	List vault entries (metadata only)	No
`vault_create`	Store a new encrypted secret	Yes
`vault_read`	Decrypt and read a secret (audit-logged)	No
`vault_update`	Update vault entry metadata	Yes
`vault_search`	Search vault entries by name/description	No

Entity Graph

Tool	Description	Mutates
`entity_graph`	Traverse the entity relationship graph	No
`schema_introspect`	Discover the full data model and entity types	No

Document Upload

Tool	Description	Mutates
`upload_document`	Upload a PDF, Markdown, or text file into Knowledge	Yes

Datasets (feature flag: `DATASETS_ENABLED=true`)

Tool	Description	Mutates
`dataset_list`	List datasets	No
`dataset_create`	Create a dataset	Yes
`dataset_query`	Query records by filters/sorts	No
`dataset_mutate`	Create/update/delete records (destructive)	Yes
`dataset_schema_modify`	Add/update/delete fields (destructive)	Yes
`dataset_summarize`	Summarize schema and sample rows	No
`dataset_facets`	Value distributions for fields	No
`dataset_quality_check`	Null rates, duplicates, uniqueness violations	No
`dataset_aggregate`	Grouped metrics (count, avg, sum, etc.)	No
`dataset_bucket`	Bucket numeric/date fields into ranges	No
`dataset_rank`	Rank records by sorts or weighted formula	No
`dataset_analyze`	Generate natural-language insights	No
`dataset_compare`	Compare metrics across segments	No
`dataset_export`	Export records as CSV	No
`dataset_join_rows`	Self-join with alias-scoped fields	No
`dataset_compute_fields`	Compute derived columns (lag, diff, rolling)	No
`dataset_timeseries`	Time series analysis with transforms	No
`dataset_materialize_result`	Save derived result as a new dataset	Yes
`dataset_plot_result`	Validate chart payload from derived result	No

Ontology (feature flag: `DATASET_ONTOLOGY_ENABLED=true`)

Tool	Description	Mutates
`object_find`	Find objects by type and property filters	No
`object_links`	Traverse graph links for an object	No
`object_action_run`	Run a declarative action on an object (destructive)	Yes

Usage Examples

1. Get project context and create a task

User prompt: "Get context for my auth project and create a task to fix the token refresh bug"

Tools invoked:

project_list — Lists projects to find the auth project
project_get_context — Retrieves tasks, notes, and signals for the project
task_create — Creates a new task with title, description, and project linkage

Result: The AI reads existing project context (open tasks, recent notes) to avoid duplicates, then creates a well-scoped task linked to the correct project.

2. Semantic code search

User prompt: "Find where we handle webhook signature verification"

Tools invoked:

codebase_search — Searches indexed code for "webhook signature verification"

Result: Returns ranked code chunks with file paths, line numbers, and surrounding context. The AI can then read the matched files to answer follow-up questions.

3. Knowledge search and note creation

User prompt: "Search for our deployment process and create a note summarizing the steps"

Tools invoked:

note_search — Searches the knowledge base for "deployment process"
code_memory_search — Searches stored code facts for deployment-related memories
note_create — Creates a new note with a markdown summary of the deployment steps

Result: The AI synthesizes information from existing notes and code memories into a single reference note, linked to the relevant project.

Resources

The server also exposes project context bundles as MCP resources:

exf://projects/{id}/context - Full context bundle for a project

Environment Variables

Variable	Required	Description
`EXF_API_URL`	Yes	ExecuFunction API URL
`EXF_PAT`	Yes	Personal Access Token

Development

bash

# Install dependencies
npm install

# Run in development mode
npm run dev

# Test with MCP Inspector
npm run inspect

# Build for production
npm run build

Security

PATs are stored as SHA-256 hashes - plaintext is never stored
Tokens can be revoked at any time from ExecuFunction Settings
Use minimal scopes for your use case
Never commit tokens to version control

Scopes

Scope	Description
`mcp:*`	All MCP operations (recommended for IDE use)
`projects:read`	Read project data
`projects:write`	Create/update projects
`tasks:read`	Read tasks
`tasks:write`	Create/update/complete tasks
`knowledge:read`	Search/read notes
`knowledge:write`	Create notes
`calendar:read`	View calendar/free slots
`calendar:write`	Create calendar events
`people:read`	Search/view contacts
`people:write`	Create/update contacts

Troubleshooting

"EXF_API_URL environment variable is required"

Make sure you've configured the env section in your MCP client config.

"Invalid token"

Check that your token starts with exf_pat_
Verify the token hasn't been revoked
Check the token hasn't expired

Tools not appearing

Restart your IDE after configuration changes
Check IDE logs for MCP errors
Try running npm run inspect to test the server directly

License

MIT

Install

Configuration

Environment variables

EXF_API_URLrequired

ExecuFunction API URL (e.g. https://execufunction.com)

EXF_PATrequiredsecret

Personal Access Token (create at Settings → Developer → Access Tokens)

claude_desktop_config.json

{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@execufunction/mcp-server@1.0.1"
      ],
      "env": {
        "EXF_API_URL": "<YOUR_EXF_API_URL>",
        "EXF_PAT": "<YOUR_EXF_PAT>"
      }
    }
  }
}

ExecuFunction MCP Server

Quick Start

1. Create a Personal Access Token

2. Configure Your MCP Client

Claude Desktop

Cursor

VS Code

3. Restart Your IDE

Available Tools

Projects

Tasks

Knowledge / Notes

People

Calendar

Codebase Indexing

Code History & Expertise

Code Memories

Vault / Secrets

Entity Graph

Document Upload

Datasets (feature flag: DATASETS_ENABLED=true)

Ontology (feature flag: DATASET_ONTOLOGY_ENABLED=true)

Usage Examples

1. Get project context and create a task

2. Semantic code search

3. Knowledge search and note creation

Resources

Environment Variables

Development

Security

Scopes

Troubleshooting

"EXF_API_URL environment variable is required"

"Invalid token"

Tools not appearing

License

Install

Configuration

Datasets (feature flag: `DATASETS_ENABLED=true`)

Ontology (feature flag: `DATASET_ONTOLOGY_ENABLED=true`)