{"_id":"@coretext-ai-public/coretext-contacts-mcp-server-fabd7200-3d00-4162-a28c-fe379e6d4509","name":"@coretext-ai-public/coretext-contacts-mcp-server-fabd7200-3d00-4162-a28c-fe379e6d4509","dist-tags":{"latest":"1.0.0"},"versions":{"1.0.0":{"name":"@coretext-ai-public/coretext-contacts-mcp-server-fabd7200-3d00-4162-a28c-fe379e6d4509","version":"1.0.0","description":"Coretext Contacts MCP Server","type":"module","main":"dist/index.js","bin":{"coretext-contacts-mcp-server":"dist/index.js"},"scripts":{"build":"tsc","dev":"tsx src/index.ts","start":"node dist/index.js","watch":"tsx --watch src/index.ts","test":"jest","lint":"eslint src/**/*.ts"},"keywords":["mcp","model-context-protocol","ai","server","google-contacts"],"author":{"name":"Coretext AI","email":"npm@coretext.ai"},"license":"MIT","dependencies":{"@modelcontextprotocol/sdk":"latest","axios":"^1.6.0","dotenv":"^16.3.0","oauth":"latest"},"devDependencies":{"@types/node":"^20.19.23","@typescript-eslint/eslint-plugin":"^7.0.0","@typescript-eslint/parser":"^7.0.0","eslint":"^8.42.0","jest":"^29.5.0","tsx":"^4.0.0","typescript":"^5.9.3"},"repository":{"type":"git","url":"git+https://github.com/coretext-ai/coretext-contacts-mcp-server.git"},"_id":"@coretext-ai-public/coretext-contacts-mcp-server-fabd7200-3d00-4162-a28c-fe379e6d4509@1.0.0","types":"./dist/index.d.ts","bugs":{"url":"https://github.com/coretext-ai/coretext-contacts-mcp-server/issues"},"homepage":"https://github.com/coretext-ai/coretext-contacts-mcp-server#readme","_integrity":"sha512-BpZRSe7kx2J3zlRVVfjhngSSeCF8A47pOCCNnTQqCj446vuwEv+jG6sFYd3bw/OBL9SyR+vKEpJxdjkMD31HXA==","_resolved":"/tmp/npm-publish-b6cjOk/@coretext-ai-public-coretext-contacts-mcp-server-fabd7200-3d00-4162-a28c-fe379e6d4509-1.0.0.tgz","_from":"file:/tmp/npm-publish-b6cjOk/@coretext-ai-public-coretext-contacts-mcp-server-fabd7200-3d00-4162-a28c-fe379e6d4509-1.0.0.tgz","_nodeVersion":"20.19.4","_npmVersion":"10.8.2","dist":{"integrity":"sha512-BpZRSe7kx2J3zlRVVfjhngSSeCF8A47pOCCNnTQqCj446vuwEv+jG6sFYd3bw/OBL9SyR+vKEpJxdjkMD31HXA==","shasum":"8f8039b70381483de42f2a87008a1fe33f28f317","tarball":"https://registry.npmjs.org/@coretext-ai-public/coretext-contacts-mcp-server-fabd7200-3d00-4162-a28c-fe379e6d4509/-/coretext-contacts-mcp-server-fabd7200-3d00-4162-a28c-fe379e6d4509-1.0.0.tgz","fileCount":42,"unpackedSize":437501,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCBZYrkZx2wU4KKfnBQV9RuTSoQJasAdiDTaDl7NJ50agIhALqvwx+4VoU2OIF2+boFsvIWIkyjP3/rhvWa78jjT1xx"}]},"_npmUser":{"name":"rugved-core","email":"rugved@coretextai.dev"},"directories":{},"maintainers":[{"name":"rugved-core","email":"rugved@coretextai.dev"},{"name":"ctxmitch","email":"mitchell@coretextai.dev"},{"name":"gerson-coretext","email":"gerson@coretextai.dev"},{"name":"armaduarte-coretextai","email":"arthur@coretextai.dev"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/coretext-contacts-mcp-server-fabd7200-3d00-4162-a28c-fe379e6d4509_1.0.0_1761231340597_0.6743361890869948"},"_hasShrinkwrap":false}},"time":{"created":"2025-10-23T14:55:40.467Z","1.0.0":"2025-10-23T14:55:40.783Z","modified":"2025-10-23T14:55:41.230Z"},"maintainers":[{"name":"rugved-core","email":"rugved@coretextai.dev"},{"name":"ctxmitch","email":"mitchell@coretextai.dev"},{"name":"gerson-coretext","email":"gerson@coretextai.dev"},{"name":"armaduarte-coretextai","email":"arthur@coretextai.dev"}],"description":"Coretext Contacts MCP Server","homepage":"https://github.com/coretext-ai/coretext-contacts-mcp-server#readme","keywords":["mcp","model-context-protocol","ai","server","google-contacts"],"repository":{"type":"git","url":"git+https://github.com/coretext-ai/coretext-contacts-mcp-server.git"},"author":{"name":"Coretext AI","email":"npm@coretext.ai"},"bugs":{"url":"https://github.com/coretext-ai/coretext-contacts-mcp-server/issues"},"license":"MIT","readme":"# coretext-contacts-mcp-server\n\nCoretext Contacts MCP Server\n\nThis MCP server was generated using the Template Orchestrator and includes the following integrations:\n\n## Available Tools\n\nThis MCP server provides 18 tools across 1 integrations:\n\n### GoogleContacts Tools\n- **google-contacts_get_person**: Get a specific contact by resource name\n- **google-contacts_create_contact**: Create a new contact with specified fields\n- **google-contacts_delete_contact**: Delete a contact permanently\n- **google-contacts_update_contact**: Update an existing contact. IMPORTANT: Include the 'etag' field in the request body to prevent conflicts. Get the current etag by first calling get_contact or from a previous create/update response.\n- **google-contacts_search_contacts**: Search across all contacts with text query\n- **google-contacts_batch_get_people**: Get multiple contacts by resource names\n- **google-contacts_list_connections**: List authenticated user's contacts\n- **google-contacts_get_contact_group**: Get a specific contact group by resource name\n- **google-contacts_copy_other_contact**: Copy an other contact to the authenticated user's contacts\n- **google-contacts_list_contact_groups**: List all contact groups\n- **google-contacts_list_other_contacts**: List other contacts (auto-created contacts from interactions)\n- **google-contacts_create_contact_group**: Create a new contact group\n- **google-contacts_delete_contact_group**: Delete a contact group\n- **google-contacts_update_contact_group**: Update an existing contact group. IMPORTANT: Include the 'etag' field in the contactGroup object to prevent conflicts. Get the current etag by first calling get_contact_group or from a previous create/update response.\n- **google-contacts_list_directory_people**: List people in the authenticated user's domain directory (G Suite/Workspace). TROUBLESHOOTING: If returns empty results, verify: 1) User is part of Google Workspace domain, 2) Directory access is enabled, 3) User has sufficient privileges (may need domain admin), 4) OAuth scopes include directory.readonly\n- **google-contacts_search_other_contacts**: Search other contacts with text query\n- **google-contacts_search_directory_people**: Search people in the authenticated user's domain directory. TROUBLESHOOTING: If returns empty results, verify: 1) User is part of Google Workspace domain, 2) Directory access is enabled, 3) User has sufficient privileges (may need domain admin), 4) OAuth scopes include directory.readonly\n- **google-contacts_modify_contact_group_members**: Add or remove members from a contact group\n\n## Installation\n\n```bash\nnpm install @coretext-ai-public/coretext-contacts-mcp-server-fabd7200-3d00-4162-a28c-fe379e6d4509\n```\n\n## Environment Setup\n\nCreate a `.env` file with the following variables:\n\n```env\nGOOGLE_OAUTH_CREDENTIALS=your_google_oauth_credentials_here\n```\n\n## Usage\n\n### Running the server\n\n```bash\n# Development mode\nnpm run dev\n\n# Production mode\nnpm run build && npm start\n```\n\n### Using with Claude Desktop\n\nAdd this to your Claude Desktop configuration:\n\n```json\n{\n  \"mcpServers\": {\n    \"coretext-contacts-mcp-server\": {\n      \"command\": \"npx\",\n      \"args\": [\"@coretext-ai-public/coretext-contacts-mcp-server-fabd7200-3d00-4162-a28c-fe379e6d4509\"],\n      \"env\": {\n        \"GOOGLE_OAUTH_CREDENTIALS\": \"your_google_oauth_credentials_here\"\n      }\n    }\n  }\n}\n```\n\n## Instructions for Fetching API Keys/Tokens\n- **COMING SOON**\n\n## Advanced Features\n\n### Request Cancellation\n\nThis MCP server supports request cancellation according to the [MCP cancellation specification](https://modelcontextprotocol.io/specification/2025-06-18/basic/utilities/cancellation). Clients can cancel in-progress requests by sending a `notifications/cancelled` message with the request ID.\n\nWhen a request is cancelled:\n- The server immediately stops processing the request\n- Any ongoing API calls are aborted\n- Resources are cleaned up\n- No response is sent for the cancelled request\n\n### Progress Notifications\n\nThe server supports progress notifications for long-running operations according to the [MCP progress specification](https://modelcontextprotocol.io/specification/2025-06-18/basic/utilities/progress). \n\nTo receive progress updates:\n1. Include a `progressToken` in your request metadata\n2. The server will send `notifications/progress` messages with:\n   - Current progress value\n   - Total value (when known)\n   - Human-readable status messages\n\nProgress is reported for:\n- Multi-step operations\n- Batch processing\n- Long-running API calls\n- File uploads/downloads\n\nExample progress notification:\n```json\n{\n  \"method\": \"notifications/progress\",\n  \"params\": {\n    \"progressToken\": \"operation-123\",\n    \"progress\": 45,\n    \"total\": 100,\n    \"message\": \"Processing item 45 of 100...\"\n  }\n}\n```\n\n## Generated Information\n\n- **Generated at**: Thu Oct 23 2025 14:54:39 GMT+0000 (Coordinated Universal Time)\n- **Orchestrator version**: 0.0.2\n- **Template repository**: Coretext-AI-Dev/server-template-v2\n- **Total endpoints**: 18\n","readmeFilename":"README.md","_rev":"1-147ef78daa529f8546c6d309cd348cfe"}